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To our brains, for always being there 



(despite shaky evidence) 
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What they’re saying about Head First 



o 

2003 



Amazon named Head First Java 
a Top Ten Editor’s Choice for 
Computer Books of 2003 
(first edition) 




Software Development Magazine named 
Head First Java a finalist for the 14 th Annual 
Jolt Cola/Product Excellence Awards 



“Kathy and Bert’s ‘Head First Java’ transforms the printed page into the closest thing to a GUI you’ve 
ever seen. In a wry, hip manner, the authors make learning Java an engaging ‘what’ re they gonna do 
next?’ experience.” 

— Warren Keuffel, Software Development Magazine 

“...the only way to decide the worth of a tutorial is to decide how well it teaches. Head First Java excels at 
teaching. OK, I thought it was silly... then I realized that I was thoroughly learning the topics as I went 
through the book.” 

“The style of Head First Java made learning, well, easier.” 

— slashdot (honestpuck’s review) 

“Beyond the engaging style that drags you forward from know-nothing into exalted Java warrior status, 

Head First Java covers a huge amount of practical matters that other texts leave as the dreaded “exercise 
for the reader...” It’s clever, wry, hip and practical — there aren’t a lot of textbooks that can make that claim 
and live up to it while also teaching you about object serialization and network launch protocols. ” 

— Dr. Dan Russell, Director of User Sciences and Experience Research 

IBM Almaden Research Center (and teaches Artificial Intelligence at Stanford University) 



“It’s fast, irreverent, fun, and engaging. Be careful — you might actually learn something!” 

— Ken Arnold, former Senior Engineer at Sun Microsystems 

Co-author (with James Gosling, creator of Java), “The Java Programming Language” 



“Java technology is everywhere — If you develop software and haven’t learned Java, it’s definitely 
time to dive in — Head First.” 

— Scott McNealy, Sun Microsystems Chairman, President and CEO 



“Head First Java is like Monty Python meets the gang of four... the text is broken up so well by puzzles 
and stories, quizzes and examples, that you cover ground like no computer book before.” 

— Douglas Rowe, Columbia Java Users Group 
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Praise for Head First Java 



“Read Head First Java and you will once again experience fun in learning... For people who like to learn 
new programming languages, and do not come from a computer science or programming background, 
this book is a gem... This is one book that makes learning a complex computer language fun. I hope 
that there are more authors who are willing to break out of the same old mold of ‘traditional’ writing 
styles. Learning computer languages should be fun, not onerous.” 

— Judith Taylor, Southeast Ohio Macromedia User Group 

“If you want to /mrwjava, look no further: welcome to the first GUI-based technical book! This 
perfectly-executed, ground-breaking format delivers benefits other Java texts simply can’t... 

Prepare yourself for a truly remarkable ride through Java land.” 

— Neil R. Bauman, Captain 8c CEO, Geek Cruises (www.GeekCruises.com) 

“If you’re relatively new to programming and you are interested in Java, here’s your book... Covering 
everything from objects to creating graphical user interfaces (GUI), exception (error) handling to net- 
working (sockets) and multithreading, even packaging up your pile of classes into one installation hie, 
this book is quite complete... If you like the style... I’m certain you’ll love the book and, like me, hope 
that the Head First series will expand to many other subjects!” 

— IinuxQuestions.org 

“I was ADDICTED to the book’s short stories, annotated code, mock interviews, and brain exercises.” 

— Michael Yuan, author, Enterprise J2ME 

“ ‘Head First Java’... gives new meaning to their marketing phrase "There’s an O Reilly for that." I 
picked this up because several others I respect had described it in terms like ‘revolutionary’ and a 
described a radically different approach to the textbook. They were (are) right... In typical O’Reilly 
fashion, they’ve taken a scientific and well considered approach. The result is funny, irreverent, topical, 
interactive, and brilliant... Reading this book is like sitting in the speakers lounge at a view conference, 
learning from - and laughing with - peers... If you want to UNDERSTAND Java, go buy this book.” 

— Andrew Pollack, www.thenorth.com 

“If anyone in the world is familiar with the concept of ‘Head First,’ it would be me. This 
book is so good, I’d marry it on TV!” 

— Rick Rockwell, Comedian 

The original FOX Television “Who Wants to Marry a Millionaire” groom 

“This stuff is so fricking good it makes me wanna WEEP! I’m stunned.” 

— Floyd Jones, Senior Technical Writer/Poolboy, BEA 

“A few days ago I received my copy of Head First Java by Kathy Sierra and Bert Bates. I’m only part way 
through the book, but what’s amazed me is that even in my sleep-deprived state that first evening, I found 
myself thinking, ‘OK, just one more page, then I’ll go to bed.’ “ 

— Joe Litton 
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Praise for other Head First books co-authored by Kathy and Bert 




Amazon named Head First Servlets 
a Top Ten Editor’s Choice for 
Computer Books of 2004 
(first edition) 




Software Development Magazine named 
Head First Servlets and Head First Design 
Patterns finalists for the 15th Annual 
Product Excellence Awards 



“I feel like a thousand pounds of books have just been lifted off of my head.” 

— Ward Cunningham, inventor of the Wiki 
and founder of the Hillside Group 



“I laughed, I cried, it moved me.” 

— Dan Steinberg, Editor-in-Chief, java.net 



“My first reaction was to roll on the floor laughing. After I picked myself up, I realized that not only is the 
book technically accurate, it is the easiest to understand introduction to design patterns that I have seen.” 

— Dr. Timothy A. Budd, Associate Professor of Computer Science at Oregon State University 
author of more than a dozen books including C++ for Java Programmers 

“Just the right tone for the geeked-out, casual-cool guru coder in all of us. The right reference for prac- 
tical development strategies — gets my brain going without having to slog through a bunch of tired 
stale professor-speak.” 

— Travis Kalanick, Founder of Scour and Red Swoosh 
Member of the MIT TR100 



“FINALLY - a Java book written the way I would ’a wrote it if I were me. 

Seriously though - this book absolutely blows away every other software book I’ve ever read... 

A good book is very difficult to write... you have to take a lot of time to make things unfold in a 
natural, “reader oriented” sequence. It’s a lot of work. Most authors clearly aren’t up to the challenge. 
Congratulations to the Head First EJB team for a first class job! 

— Wally Flint 

“I could not have imagined a person smiling while studying an IT book! Using Head First EJB 
materials, I got a great score (91%) and set a world record as the youngest SCBCD, 14 years.” 

— Afsah Shafquat (world’s youngest SCBCD) 

“This Head First Servlets book is as good as the Head First EJB book, which made me laugh 
AND gave me 97% on the exam!” 

— Jef Cumps, J2EE consultant, Cronos 
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Other related books from O’Reilly 

Ant: The Definitive Guide 
Better, Faster, Lighter Java™ 

Enterprise JavaBeans™ 3.0 

Hibernate: A Developer’s Notebook 

Java™ 1 .5 Tiger: A Developer’s Notebook 

Java™ Cookbook 

Java™ in a Nutshell 

Java™ Network Programming 

Java™ Servlet & JSP Cookbook 

Java™ Swing 

JavaServer™ Faces 

JavaServer Pages™ 

Programming Jakarta Struts 
Tomcat: The Definitive Guide 



Other books in O’Reilly’s Head First series 

Head First Java™ 

Head First Object-Oriented Analysis and Design (OOA&D) 
Head Rush Ajax 

Head First HTML with CSS and XHTML 
Head First Design Patterns 
Head First EJB™ 

Head First PMP 
Head First SQL 

Head First Software Development 
Head First C# 

Head First JavaScript 

Head First Programming (2008) 

Head First Ajax (2008) 

Head First Physics (2008) 

Head First Statistics (2008) 

Head First Ruby on Rails (2008) 

Head First PHP & MySQL (2008) 
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how to use this book 



Who is this book for? 

If you can answer “yes” to all of these: 

0 Have you done some programming? 

^2) Do you want to learn Java? 

( 3 ) Do you prefer stimulating dinner party 
conversation to dry, dull, technical 
lectures? 

this book is for you. 



This is NOT a reference 
book. Head First Java is a 
book designed for learning, 
not an encyclopedia of 
Java facts. 



Who should probably back away from this book? 

If you can answer “yes” to any one of these: 

@ Is your programming background limited 
to HTML only, with no scripting language 
experience? 

(If you’ve done anything with looping, or if/ then 
logic, you’ll do fine with this book, but HTML 
tagging alone might not be enough.) 

(g) Are you a kick-butt C++ programmer 
looking for a reference book? 

( 3 ) Are you afraid to try something different? 
Would you rather have a root canal than 
mix stripes with plaid? Do you believe 
than a technical book can’t be serious if 
there’s a picture of a duck in the memory 
management section? 

this book is not for you. 




Cr\oic from 
"this book is 
abou-fc -fcha-t 
disdussed... 
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the intro 



We know what you're thinking. 



“How can this be a serious Java programming book?” 
“What’s with all the graphics?” 

“Can I actually learn it this way?” 

“Do I smell pizza?” 




And we know what your brain is thinking. 

Your brain craves novelty. It’s always searching, scanning, waiting for 
something unusual. It was built that way, and it helps you stay alive. 

Today, you’re less likely to be a tiger snack. But your brain’s still 
looking. You just never know. 

So what does your brain do with all the routine, ordinary, normal 
things you encounter? Everything it can to stop them from 
interfering with the brain’s realyoh — recording things that matter. It 
doesn’t bother saving the boring things; they never make it past the 
“this is obviously not important” filter. 

How does your brain know what’s important? Suppose you’re out for 
a day hike and a tiger jumps in front of you, what happens inside your 
head? 

Neurons fire. Emotions crank up. Chemicals surge. 

And that’s how your brain knows... 

This must be important! Don’t forget it! 

But imagine you’re at home, or in a library. It’s a safe, warm, tiger-free 
zone. You’re studying. Getting ready for an exam. Or trying to learn 
some tough technical topic your boss thinks will take a week, ten days 
at the most. 

Just one problem. Your brain’s trying to do you a big favor. It’s 
trying to make sure that this obviously non-important content 
doesn’t clutter up scarce resources. Resources that are better 
spent storing the really big things. Like tigers. Like the danger of 
fire. Like how you should never again snowboard in shorts. 

And there’s no simple way to tell your brain, “Hey brain, thank 
you very much, but no matter how dull this book is, and how 
little I’m registering on the emotional rich ter scale right now, I 
really ^owant you to keep this stuff around.” 



■ s “ 




Great. Only 
637 more dull, dry, 
boring pages. 
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how to use this book 



We 



iifink of a ‘Head First Java’ reader as a learner. 




"«ds to U u a 
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So what does it take to learn the 
you don’t forget it. It’s not about pushmg ^ educatjonal psychology, 

/e^ming^k^a a P a ^ e ' know whatturns your bra n on ‘ 

Some of the Head First learning principles: 

bottom or on another page, and learners will be up to tm« 
as likely to solve problems related to the content. 

. stvle. In recent studies, 

u». « conversational *"^* r * „ nsts « tte »'** 

dinner party companion, or a lecture? 



RMl vcrnobc 

sC y\/\tC 




jT 



* think more deeply- In other words, unless 

Get the learner to murh happens in your head. > 

you actively flex your neurons, nothing m ^ ( Bathro om ! 

A reader has to be motivated, engage , ^ ^ knowled ge. 

r0am i of the brain, and multiple senses. 

- * and Keep-the reader’s attention. We've all 

page one experienc . unexpected. Learning a new, 

Tenon their «• »°» 

dependent on its emotional conten ^ wrenching stories about a boy and h.s dog. 

you feel something. No we're not talking hea ( and the feeling of "I Rule! ■ 

We're talking emotions like surprise, curiosity, fum ^ hard>or realize 

you know something tnat 
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the intro 



Metacognition: thinking about thinking. 

If you really want to learn, and you want to learn more quickly and more deeply, f I wonder how I 
pay attention to how you pay attention. Think about how you think. Learn how s can trick my brain 

you learn. \ m ^° remembering 

this stuff... 

Most of us did not take courses on metacognition or learning theory when we were 
growing up. We were expected to learn, but rarely taught to learn. 

But we assume that if you’re holding this book, you want to learn Java. And you 
probably don’t want to spend a lot of time. 

To get the most from this book, or any book or learning experience, take 
responsibility for your brain. Your brain on that content. 

The trick is to get your brain to see the new material you’re learning 
as Really Important. Crucial to your well-being. As important as 
a tiger. Otherwise, you’re in for a constant battle, with your brain 
doing its best to keep the new content from sticking. 



So just how DO you get your brain to treat Java like 
was a hungry tiger? 

There’s the slow, tedious way, or the faster, more effective way. The 
slow way is about sheer repetition. You obviously know that you are 
able to learn and remember even the dullest of topics, if you keep pounding 
on the same thing. With enough repetition, your brain says, “This doesn’t feel 
important to him, but he keeps looking at the same thing ot^rand over and over, so 
I suppose it must be.” 

The faster way is to do anything that increases brain activity, especially different types 
of brain activity. The things on the previous page are a big part of the solution, 
and they’re all things that have been proven to help your brain work in your favor. 
For example, studies show that putting words within the pictures they describe (as 
opposed to somewhere else in the page, like a caption or in the body text) causes 
your brain to try to makes sense of how the words and picture relate, and this 
causes more neurons to fire. More neurons firing = more chances for your brain 
to get that this is something worth paying attention to, and possibly recording. 




A conversational style helps because people tend to pay more attention when they 
perceive that they’re in a conversation, since they’re expected to follow along and 
hold up their end. The amazing thing is, your brain doesn’t necessarily care that 
the “conversation” is between you and a book! On the other hand, if the writing 
style is formal and dry, your brain perceives it the same way you experience being 
lectured to while sitting in a roomful of passive attendees. No need to stay awake. 

But pictures and conversational style are just the beginning. 
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how to use this book 



Here's what WE did: 

We used pictures , because your brain is tuned for visuals, not text. As far as your 
brain’s concerned, a picture really is worth 1024 words. And when text and pictures 
work together, we embedded the text in the pictures because your brain works 
more effectively when the text is within the thing the text refers to, as opposed to in 
a caption or buried in the text somewhere. 

We used repetition , saying the same thing in different ways and with different media 
types, and multiple senses, to increase the chance that the content gets coded coded 
into more than one area of your brain. 

We used concepts and pictures in unexpected ways because your brain is tuned for 
novelty, and we used pictures and ideas with at least some emotional content, because 
your brain is tuned to pay attention to the biochemistry of emotions. That which 
causes you to feel something is more likely to be remembered, even if that feeling is 
nothing more than a little humor, surprise, or interest. 

We used a personalized, conversational style, because your brain is tuned to pay more 
attention when it believes you’re in a conversation than if it thinks you’re passively 
listening to a presentation. Your brain does this even when you’re reading. 

We included more than 50 exercises , because your brain is tuned to learn and 
remember more when you do things than when you read about things. And we 
made the exercises challenging-yet-do-able, because that’s what most people prefer. 

We used multiple learning styles, because you might prefer step-by-step procedures, 
while someone else wants to understand the big picture first, while someone else 
just wants to see a code example. But regardless of your own learning preference, 
everyone benefits from seeing the same content represented in multiple ways. 

We include content for both sides of your brain, because the more of your brain you 
engage, the more likely you are to learn and remember, and the longer you can 
stay focused. Since working one side of the brain often means giving the other side 
a chance to rest, you can be more productive at learning for a longer period of 
time. 





And we included stories and exercises that present more than one point of view, 
because your brain is tuned to learn more deeply when it’s forced to make 
evaluations and judgements. 

We included challenges, with exercises, and by asking questions that don’t always have 
a straight answer, because your brain is tuned to learn and remember when it has 
to work at something (just as you can’t get your body in shape by watching people 
at the gym) . But we did our best to make sure that when you’re working hard, it’s 
on the right things. That you’re not spending one extra dendrite processing a hard-to- 
understand example, or parsing difficult, jargon-laden, or extremely terse text. 

We used an 80/20 approach. We assume that if you’re going for a PhD in Java, 
this won’t be your only book. So we don’t talk about everything. Just the stuff you’ll 
actually use. 
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the intro 




Here's what YOU can do to bend your 
brain into submission. 

So, we did our part. The rest is up to you. These tips are a 
starting point; Listen to your brain and figure out what works 
for you and what doesn’t. Try new things. 

*kk it 

0h y° ulr '"tridjeHh*. 



0 Slow down. The more you understand, 
the less you have to memorize. 

Don’t just read. Stop and think. When the 
book asks you a question, don’t just skip to 
the answer. Imagine that someone really is 
asking the question. The more deeply you 
force your brain to think, the better chance 
you have of learning and remembering. 

(g) Do the exercises. Write your own notes. 

We put them in, but if we did them for you, 
that would be like having someone else 
do your workouts for you. And don’t just 
look at the exercises. Use a pencil. There’s 
plenty of evidence that physical activity 
while learning can increase the learning. 

(3) Read the “There are No Dumb Questions” 

That means all of them. They’re not 
optional side-bars — they’re part of the core 
content! Sometimes the questions are more 
useful than the answers. 

( 4 ) Don’t do all your reading in one place. 

Stand-up, stretch, move around, change 
chairs, change rooms. It’ll help your brain 
feel something, and keeps your learning from 
being too connected to a particular place. 

0 Make this the last thing you read before 
bed. Or at least the last challenging thing, 

Part of the learning (especially the transfer 
to long-term memory) happens after you put 
the book down. Your brain needs time on 
its own, to do more processing. If you put in 
something new during that processing-time, 
some of what you just learned will be lost. 



(6) Drink water. Lots of it. 

Your brain works best in a nice bath of fluid. 
Dehydration (which can happen before you 
ever feel thirsty) decreases cognitive function. 

( 7 ) Talk about it. Out loud. 

Speaking activates a different part of 
the brain. If you’re trying to understand 
something, or increase your chance of 
remembering it later, say it out loud. Better 
still, try to explain it out loud to someone 
else. You’ll learn more quickly, and you might 
uncover ideas you hadn’t known were there 
when you were reading about it. 

(8) Listen to your brain. 

Pay attention to whether your brain is getting 
overloaded. If you find yourself starting to skim 
the surface or forget what you just read, it’s 
time for a break. Once you go past a certain 
point, you won’t learn faster by trying to shove 
more in, and you might even hurt the process. 

( 9 ) Feel something! 

Your brain needs to know that this matters. Get 
involved with the stories. Make up your own 
captions for the photos. Groaning over a bad 
joke is still better than feeling nothing at all. 

0) Type and run the code. 

Type and run the code examples. Then you 
can experiment with changing and improving 
the code (or breaking it, which is sometimes 
the best way to figure out what’s really 
happening). For long examples or Ready-bake 
code, you can download the source hies from 
headhrstjava.com 
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how to use this book 



What you need for this book: 



You do not need any other development tool, such as an Integrated 
Development Environment (IDE). We strongly recommend that you not 
use anything but a basic text editor until you complete this book (and 
especially not until after chapter 16 ) . An IDE can protect you from some of 
the details that really matter, so you’re much better off learning from the 
command-line and then, once you really understand what’s happening, 
move to a tool that automates some of the process. 




SETTING UP JAVA 

■ If you don’t already have a 1 .5 or greater Java 2 Standard Edition SDK (Software 
Development Kit), you need it. If you’re on Linux, Windows, or Solaris, you can get it for free 
from java.sun.com (Sun’s website for Java developers). It usually takes no more than two clicks 
from the main page to get to the J2SE downloads page. Get the latest non-beta version posted. 
The SDK includes everything you need to compile and run Java. 

If you’re running Mac OS X 10.4, the Java SDK is already installed. It’s part of OS X, and you 
don’t have to do anything else. If you’re on an earlier version of OS X, you have an earlier 
version of Java that will work for 95% of the code in this book. 

Note: This book is based on Java 1.5, but for stunningly unclear marketing reasons, shortly 
before release, Sun renamed it Java 5, while still keeping “1 .5” as the version number for the 
developer’s kit. So, if you see Java 1 .5 or Java 5 or Java 5.0, or "Tiger" (version 5’s original 
code-name), they all mean the same thing. There was never a Java 3.0 or 4.0— it jumped from 
version 1 .4 to 5.0, but you will still find places where it’s called 1 .5 instead of 5. Don't ask. 

(Oh, and just to make it more entertaining, Java 5 and the Mac OS X 10.4 were both given the 
same code-name of “Tiger”, and since OS X 10.4 is the version of the Mac OS you need to run 
Java 5, you’ll hear people talk about “Tiger on Tiger”. It just means Java 5 on OS X 10.4). 

■ The SDK does not include the API documentation, and you need that! Go back to java.sun. 
com and get the J2SE API documentation. You can also access the API docs online, without 
downloading them, but that’s a pain. Trust us, it’s worth the download. 

■ You need a text editor. Virtually any text editor will do (vi, emacs, pico), including the GUI ones 
that come with most operating systems. Notepad, Wordpad, TextEdit, etc. all work, as long as 
you make sure they don’t append a “.txt” on to the end of your source code. 

■ Once you’ve downloaded and unpacked/zipped/whatever (depends on which version and for 
which OS), you need to add an entry to your PATH environment variable that points to the / bin 
directory inside the main Java directory. For example, if the J2SDK puts a directory on your 
drive called “j2sdk1 .5.0”, look inside that directory and you’ll find the “bin” directory where the 
Java binaries (the tools) live. Tha bin directory is the one you need a PATH to, so that when you 
type: 

% j avac 

at the command-line, your terminal will know how to find the javac compiler. 

Note: if you have trouble with you installation, we recommend you go to javaranch.com, and join 
the Java-Beginning forum! Actually, you should do that whether you have trouble or not. 

Note: much of the code from this book is available at wickedlysmart.com 
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the intro 



last-minute things you need to know: 

This is a learning experience, not a reference book. We deliberately 
stripped out everything that might get in the way of learning whatever it 
is we’re working on at that point in the book. And the first time through, 
you need to begin at the beginning, because the book makes assumptions 
about what you’ve already seen and learned. 

We use simple UML-fifce diagrams. 

If we’d used pure UML, you’d be seeing something that looks like Java, but 
with syntax that’s just plain wrong. So we use a simplified version of UML 
that doesn’t conflict with Java syntax. If you don’t already know UML, you 
won’t have to worry about learning Java and UML at the same time. 

We don’t worry about organizing and packaging your own 
code until the end of the book. 

In this book, you can get on with the business of learning Java, without 
stressing over some of the organizational or administrative details of 
developing Java programs. You will, in the real world, need to know — and 
use — these details, so we cover them in depth. But we save them for the end 
of the book (chapter 17 ). Relax while you ease into Java, gently. 

The end-of-chapter exercises are mandatory; puzzles are 
optional. Answers for both are at the end of each chapter. 

One thing you need to know about the puzzles — they’re puzzles. As in logic 
puzzles, brain teasers, crossword puzzles, etc. The exercises are here to help 
you practice what you’ve learned, and you should do them all. The puzzles 
are a different story, and some of them are quite challenging in a puzzle 
way. These puzzles are meant for puzzlers, and you probably already know if 
you are one. If you’re not sure, we suggest you give some of them a try, but 
whatever happens, don’t be discouraged if you can’t solve a puzzle or if you 
simply can’t be bothered to take the time to work them out. 

The ‘Sharpen Your Pencil’ exercises don’t have answers. 

Not printed in the book, anyway. For some of them, there is no right 
answer, and for the others, part of the learning experience for the Sharpen 
activities is for you to decide if and when your answers are right. (Some of 
our suggested answers are available on wickedlysmart.com) 

The code examples are as lean as possible 

It’s frustrating to wade through 200 lines of code looking for the two lines 
you need to understand. Most examples in this book are shown within the 
smallest possible context, so that the part you’re trying to learn is clear and 
simple. So don’t expect the code to be robust, or even complete. That’s 
your assignment for after you finish the book. The book examples are 
written specifically for learning, and aren’t always fully-functional. 



us t 3 
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Dog 



size 



bark() 

eat() 

chaseCatQ 






Vow sViowld do AL-U 
0-f tv* "Sharp 
activities 





you are here ► xxix 



Head First Java, 2nd Edition. Head First Java, 2nd Edition, ISBN: 0596009208 

Prepared for e.simons@icarin.fiuc.org, Eduard Simons 

Copyright © 2005 Bert Bates and Kathy Sierra. This PDF is made available for personal use only during the relevant subscription term, subject to the Safari Terms of Service. Any other use 
requires prior written consent from the copyright owner. Unauthorized use, reproduction and/or distribution are strictly prohibited and violate applicable laws. All rights reserved. 



tech editing: Jessica and Valentin 



technical Editors 



“Credit goes to all, but mistakes are the sole reponsibility of the 
author...”. Does anyone really believe that? See the two people on 
this page? If you find technical problems, it’s probably their fault. : ) 



l/aleivfci* Crcliaz 



Jcss'ta 




Jessica £a h £ 



Jess works at Hewlett-Packard on the Self- 
Healing Services Team. She has a Bachelor’s 
in Computer Engineering from Villanova 
University, has her SCPJ 1.4 and SCWCD 
certifications, and is literally months away 
from receiving her Masters in Software 
Engineering at Drexel University (whew!) 

When she’s not working, studying or 
motoring in her MINI Cooper S, Jess can 
be found fighting her cat for yarn as she 
completes her latest knitting or crochet 
project (anybody want a hat?) She is 
originally from Salt Lake City, Utah (no, 
she’s not Mormon... yes, you were too 
going to ask) and is currently living near 
Philadelphia with her husband, Mendra, and 
two cats: Chai and Sake. 

You can catch her moderating technical 
forums atjavaranch.com. 




Valentin Valentin Crettaz has a Masters degree 
in Information and Computer Science from 
the Swiss Federal Institute of Technology in 
Lausanne (EPFL) . He has worked as a software 
engineer with SRI International (Menlo Park, 
CA) and as a principal engineer in the Software 
Engineering Laboratory of EPFL. 

Valentin is the co-founder and CTO of Condris 
Technologies, a company specializing in the 
development of software architecture solutions. 

His research and development interests 
include aspect-oriented technologies, design 
and architectural patterns, web services, and 
software architecture. Besides taking care of 
his wife, gardening, reading, and doing some 
sport, Valentin moderates the SCBCD and 
SCDJWS forums atjavaranch.com. He holds 
the SCJP, SCJD, SCBCD, SCWCD, and SCDJWS 
certifications. He has also had the opportunity 
to serve as a co-author for Whizlabs SCBCD 
Exam Simulator. 

(We’re still in shock from seeing him in a tie.) 
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the intro 



Credi-t 



Other people tobte 'we: 

At O’Reilly: 

Our biggest thanks to Mike Loukides at O’Reilly, for taking a 
chance on this, and helping to shape the Head First concept into 
a book (and series ) . As this second edition goes to print there 
are now five Head First books, and he’s been with us all the way. 

To Tim O’Reilly, for his willingness to launch into something 
completely new and different. Thanks to the clever Kyle Hart for 
figuring out how Head First fits into the world, and for launching 
the series. Finally, to Edie Freedman for designing the Head First 
“emphasize the head ’ cover. 

Our intrepid beta testers and reviewer team: 

Our top honors and thanks go to the director of our javaranch 
tech review team, Johannes de Jong. This is your fifth time around 
with us on a Head First book, and we’re thrilled you’re still speaking 
to us. Jeff Cumps is on his third book with us now and relentless 
about finding areas where we needed to be more clear or correct. 

Corey McGlone, you rock. And we think you give the clearest 
explanations on javaranch. You’ll probably notice we stole one or 
two of them. Jason Menard saved our technical butts on more 
than a few details, and Thomas Paul, as always, gave us expert 
feedback and found the subtle Java issues the rest of us missed. 
Jane Griscti has her Java chops (and knows a thing or two about 
writing) and it was great to have her helping on the new edition 
along with long-time javarancher Barry Gaunt. 

Marilyn de Queiroz gave us excellent help on both editions of the 
book. Chris Jones, John Nyquist, James Cubeta, Terri Cubeta, 
and Ira Becker gave us a ton of help on the first edition. 




' Pau/ 



Cur*ps 



Some ot owr Java 

eyjpevt veviewev-s... 



Special thanks to a few of the Head Firsters who’ve been helping 
us from the beginning: Angelo Celeste, Mikalai Zaikin, and 
Thomas Duff (twduff.com). And thanks to our terrific agent, David 
Rogelberg of StudioB (but seriously, what about the movie rights?) 




Mav-ily de 

Queiroz. 
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still more acknowledgements 



Just whew you thought there wouldn't be any 
more acknowledgements*. 



More Java technical experts who helped out on the first edition (in pseudo-random order): 

Emiko Hori, Michael Taupitz, Mike Gallihugh, Manish Hatwalne, James Chegwidden, 
Shweta Mathur, Mohamed Mazahim, John Paverd, Joseph Bih, Skulrat Patanavanich, 

Sunil Palicha, Suddhasatwa Ghosh, Ramki Srinivasan, Alfred Raouf, Angelo Celeste, 
Mikalai Zaikin, John Zoetebier, Jim Pleger, Barry Gaunt, and Mark Dielen. 

The first edition puzzle team: 

Dirk Schreckmann, Mary “JavaCross Champion” Leners, Rodney J. Woodruff, Gavin Bong, 
and Jason Menard. Javaranch is lucky to have you all helping out. 

Other co-conspirators to thank: 

Paul Wheaton, the javaranch Trail Boss for supporting thousands of Java learners. 

Solveig Haugland, mistress ofJ 2 EE and author of “Dating Design Patterns”. 

Authors Dori Smith and Tom Negrino (backupbrain.com), for helping us navigate the 
tech book world. 

Our Head First partners in crime, Eric Freeman and Beth Freeman (authors of Head First 
Design Patterns), for giving us the Bawls™ to finish this on time. 

Sherry Dorris, for the things that really matter. 



Brave Early Adopters of the Head First series: 

Joe Litton, Ross P. Goldberg, Dominic Da Silva, honestpuck, Danny Bromberg, Stephen 
Lepp, Elton Hughes, Eric Christensen, Vulinh Nguyen, Mark Rau, Abdulhaf, Nathan 
Oliphant, Michael Bradly, Alex Darrow, Michael Fischer, Sarah Nottingham, Tim Allen, 
Bob Thomas, and Mike Bibby (the first) . 



*The large number of acknowledgements is because we’re testing the theory that everyone mentioned in 
a book acknowledgement will buy at least one copy, probably more, what with relatives and everything. If 
you’d like to be in the acknowledgement of our next book, and you have a large family, write to us. 
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1 dive in A Quick Dip 



Breaking the Surface 




Java takes you to new places. From its humble release to the public as the 
(wimpy) version 1.02, Java seduced programmers with its friendly syntax, object-oriented features, 
memory management, and best of all — the promise of portability.The lure of write-once/run- 
anywhere is just too strong. A devoted following exploded, as programmers fought against bugs, 
limitations, and, oh yeah, the fact that it was dog slow. But that was ages ago. If you're just starting in 
Java, you’re lucky. Some of us had to walk five miles in the snow, uphill both ways (barefoot), to 
get even the most trivial applet to work. But you, why, you get to ride the sleeker, faster, much 
more powerful Java of today. 
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the way Java works 



The Way Java Works 

The goal is to write one application (in this 
example, an interactive party invitation) and have 
it work on whatever device your friends have. 



source code for 
the interactive 
party invitation. 









Source 

O 

Create a source 
document. Use an 
established protocol 
(in this case, the Java 
language). 





Compiler 

© 

Run your document 
through a source code 
compiler. The compiler 
checks for errors and 
won't let you compile 
until it's satisfied that 
everything will run 
correctly. 



Virtual 

Machines 



Your friends don't have 
a physical Java Machine, 
but they all have a 
virtual Java machine 
(implemented in 
software) running inside 
their electronic gadgets. 
The virtual machine reads 
and runs the bytecode. 



Output 

(code) 



© 

The compiler creates a 
new document, coded 
into Java bytecode. 

Any device capable of 
running Java will be able 
to interpret/translate 
this file into something 
it can run. The compiled 
bytecode is platform- 
independent. 



Method Party() 
0 aload_0 



1 invokespe- 
cial #1 <Method 
java.lang.Object()> 



4 return 
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dive In A Quick Dip 



What you'll do in Java 

You’ll type a source code file, compile it using the 
javac compiler, then run the compiled bytecode 
on a Java virtual machine. 



import java.awt.*; 
import java.awt.event.*; 
class Party { 
public void buildlnvite() { 

Frame f = new Frame(); 

Label I = new Label(“Party at Tim’s”); 
Button b = new Button(“You bet”); 
Button c = new ButtonfShoot me”); 
Panel p = new Panel(); 
p.add(l); 

} II more code here... 

} 



Source 

O 

Type your source code. 
Save as: Party.java 



File Edit Window Help Plead 



% j avac Party . j ava 



Compiler 




Compile the Party.java 
file by running javac 
(the compiler application). 
If you don't have errors, 
you'll get a second docu- 
ment named Party.class 



Method Party() 

0 aload_0 

1 invokespecial #1 <Method 
java.lang.Object()> 

4 return 

Method void buildlnvite() 

0 new #2 <Class java.awt.Frame> 

3 dup 

4 invokespecial #3 <Method 
java.awt.Frame()> 



Output 

(code) 



The compiler-generated 
Party.class file is made up 
of bytecodes. 



© 

Compiled code: Party.class 






%java Party 



©oo 

Party at Tim’s! 

( Shoot M> ) 



Virtual 

Machines 

O 

Run the program by 
starting the Java Virtual 
Machine (JVM) with the 
Party.class file. The JVM 
translates the bytecode 
into something the 
underlying platform 
understands, and runs 
your program. 



(Noie : "this is not meant to be a tutorial- ■■ you II be 
wv-itin^ real Code in a moment, but £or now, we just 
want you to ^et a -feel -for bow it all -fits together.) 
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A very brief history of Java 
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Java 1.02 

250 classes 



Java 1.1 

500 classes 



Java 2 

(versions 1.2 - 1.4) 



Java 5.0 
(versions 1.5 and up) 



Slow. 



A little faster. 



2300 classes 



3500 classes 



Cute name and logo 
Fun to use. Lots of 
bugs. Applets are 
the Big Thing. 

flavors: Micro Edition (J2ME), 
Standard Edition (J2SE) and 
Enterprise Edition (J2EE). 
Becomes the language of 
choice for new enterprise 
(especially web-based) and 
mobile applications. 



More capable, friendlier. 
Becoming very popular. 
Better GUI code. 



Much faster. 

Can (sometimes) run at 
native speeds. Serious, 
powerful. Comes in three 



More power, easier to 
develop with. 

Besides adding more than a 
thousand additional classes, 
Java 5.0 (known as "Tiger") 
added major changes to 
the language itself, making 
it easier (at least in theory) 
for programmers and giving 
it new features that were 
popular in other languages. 
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chapter 1 



dive In A Quick Dip 



Sharpen your pencil 

Try to guess what each line of code is doing... 
(answers are on the next page). 

int size = 27; 

String name = "Fido"; 

Dog myDog = new Dog(name, size); 
x = size - 5; 

if (x < 15) myDog . bark ( 8 ) ; 

while (x > 3) { 
myDog. play ( ) ; 

} 

int[] numList = {2, 4, 6, 8}; 

System. out .print ( "Hello" ) ; 

System. out .print ( "Dog: " + name); 

String num = "8"; 
int z = Integer .parselnt( num) ; 

try { 

readTheFile ( "myFile . txt" ) ; 

} 

catch (FileNotFoundException ex) { 

System. out .print ( "File not found."); 

} 




Look how easy it 
is to write Java. 



0? I see Java 2 and Java 5.0, but was there a Java 3 
and 4? And why is it Java 5.0 but not Java 2.0? 



The joys of marketing... when the version of Java 
shifted from 1 .1 to 1 .2, the changes to Java were so 
dramatic that the marketers decided we needed a whole 
new "name" so they started calling it Java 2, even though 
the actual version of Java was 1 .2. But versions 1 .3 and 1 .4 
were still considered Java 2. There never was a Java 3 or 
4. Beginning with Java version 1 .5, the marketers decided 



once again that the changes were so dramatic that a 
new name was needed (and most developers agreed), so 
they looked at the options. The next number in the name 
sequence would be "3" but calling Java 1.5 Java 3 seemed 
more confusing, so they decided to name it Java 5.0 to 
match the "5" in version "1.5" 

So, the original Java was versions 1 .02 (the first official 
release) through 1.1 were just "Java" Versions 1 .2, 1 .3, and 
1 .4 were "Java 2" And beginning with version 1 .5, Java is 
called "Java 5.0" But you'll also see it called "Java 5" (without 
the".0") and "Tiger" (its original code-name). We have no 
idea what will happen with the next release... 
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why Java is cool 



Sharpen your pencil answers 



Look how easy It 
is to write Java. 



Don't worry about whether you understand any of this yet! 

Everything here is explained in great detail in the book, most 
within the first 40 pages). If Java resembles a language you've 
used in the past, some of this will be simple. If not, don't worry 
about it. We'll get there... 



int size = 27; 

String name = "Fido"; 

Dog myDog = new Dog(name, size); 
x = size - 5; 

if (x < 15) myDog . bark ( 8 ) ; 

while (x > 3) { 
myDog. play ( ) ; 

} 

int[] numList = {2, 4 , 6 , 8}; 

System. out .print ( "Hello" ) ; 

System. out .print ( "Dog: " + name); 

String num = "8"; 

int z = Integer .parselnt( num) ; 

try { 

readTheFile ( "myFile . txt" ) ; 

} 

catch (FileNotFoundException ex) { 
System. out .print ( "File not found. 

} 



dcdlavc a* integer variable named Viz* and 9 'ive it the value 2-7 
dedlare a string of dharadters variable named Van* and <yve it the value "Fido” 
dedlare a new D 09 variable 'myDo^ and make the new D 03 usin^ 'name and 'siz V 
subtradt 5 -from Z7 (value o-f 'siz* ) and assign it to a variable named V 
if x (value of 2 . 2 .) is less than 15, tell the do<\ to bark 8 times 



keep looping as lon^ as x is greater than 3... 

tell the dog to play (whatever THAT means to a do<y.) 



this looks like the end of the 







dedlare a list of integers variable 'numList^ and put into the list- 
print out "Hello” .. probably at the dommand-line 
print out "Hello Fido” (the value of 'nan* is "Fido”) at the dommand-line 
dedlare a dharadter string variable 'num' and ^ive it the value of "8” 
donvert the string of dharadters " 8 ” into an adtual numerid value @ 



) ; 



tvy to do something . maybe the tbin^ were trying isnt guaranteed to work... 
read a tex.t file named "myFile-txt” (or at least TRY to read the f ile...) 
must be the end of the "things to try”, so | cjuess you dould tvy many things... 
this must be where you f ind out if the thin^ you tried didn t work - 
if the thin^ we tvied failed, print "File not found” out at the dommand-line 
looks like everything in the { } is what to do if the 'tvy* didn t work- 
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dive In A Quick Dip 



Code structure m Java 




Put a class in a source file. 
Put methods in a class. 

Put statements in a method. 



What goes in a 

source file? 

A source code file (with the .java 
extension) holds one class defini- 
tion. The class represents a piece 
of your program, although a very 
tiny application might need just 
a single class. The class must go 
within a pair of curly braces. 



What goes in a 

class? 

A class has one or more methods. 
In the Dog class, the bark method 
will hold instructions for how the 
Dog should bark. Your methods 
must be declared inside a class 
(in other words, within the curly 
braces of the class) . 



What goes in a 

method? 

Within the curly braces of a 
method, write your instructions 
for how that method should be 
performed. Method code is basi- 
cally a set of statements, and for 
now you can think of a method 
kind of like a function or proce- 
dure. 
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a Java class 



Anatomy of a class 

When the JVM starts running, it looks for the class you give it at the com- 
mand line. Then it starts looking for a specially-written method that looks 
exactly like: 

public static void main (String [] args) { 

// your code goes here 



Next, the JVM runs everything between the curly braces { } of your main 
method. Every Java application has to have at least one class, and at least 
one main method (not one main per class) just one main per application). 





dos'rng bvade o-f the M yFiv-stApp ^lass 



Pont wovvy about memovizjing anything might now - 
-this dhayiev* is just to get you started- 
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dive In A Quick Dip 



Writing a class with a main 

In Java, everything goes in a class. You’ll type your source code file (with a 
.java extension), then compile it into a new class file (with a .class extension). 
When you run your program, you’re really running a class. 

Running a program means telling the Java Virtual Machine (JVM) to “Load the 
Hello class, then start executing its main ( ) method. Keep running ‘til all the 
code in main is finished.” 

In chapter 2, we go deeper into the whole class thing, but for now, all you need to 
think is, how do I write Java code so that it will run? And it all begins with main(). 

The main() method is where your program starts running. 

No matter how big your program is (in other words, no matter how many classes 
your program uses), there’s got to be a mainQ method to get the ball rolling. 



public class MyFirstApp { 

public static void main 
(StringO args) { 

System.out.printfl Rule!"); 

} 

} 



MyFirstApp.java 




— 

public class MyFirstApp { 

public static void main (String [] args) { 
System . out . println ( " I Rule ! " ) ; 

System . out . println ( "The World" ) ; 

} 



Q Save 

MyFirstApp . java 



@ Compile 

j avac MyFirstApp . j ava 



©Run 



File Edit Window Help Scream 



%java MyFirstApp 
I Rule! 

The World 
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statements, looping, branching 



What caw you say iw the main method? 

Once you’re inside main (or any method), the fun 
begins. You can say all the normal things that you say 
in most programming languages to make the computer 
do something. 

Your code can tell the JVM to: 



0 do something 



Statements: declarations, assignments, 
method calls, etc. 

int x = 3; 

String name = "Dirk"; 
x = x * 17; 

System. out . print ("x is " + 
double d = Math . random () ; 
// this is a comment 



x) ; 



e do something again and again 

Loops: for and while 



while (x > 12) { 

x = x - 1 ; 




Syntax 

Fun 



* Each statement must end in a 
semicolon. 



for (int x=0;x<10;x=x+l) { 

System. out .print ("x is now " + x) ; 

} 



X = X + 1 / 

* A single-line comment begins 
with two forward slashes. 



0 do something under this condition 

Branching: if /else tests 

if (x == 10) { 

System. out .print ("x must be 10"); 

} else { 

System. out .print ("x isn't 10"); 

} 

if ( (x < 3) & (name . equals ( "Dirk" )) ) { 

System. out .print in ("Gently") ; 

} 

System . out . print ( "this line runs no matter what"); 



x = 22; 

// this line disturbs me 

* Most white space doesn't matter. 

x = 3 ; 

* Variables are declared with a 
name and a type (you'll learn about 
all the Java types in chapter 3). 

int weight; 

//type: int, name: weight 

Classes and methods must be 
defined within a pair of curly braces. 

public void go ( ) { 

// amazing code here 

} 
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dive In A Quick Dip 



{ 



% 



while (moreBalls == true) 
keepJuggling(); 



} 



5 




looping and looping and... 



Java has three standard looping constructs: while, 
do-while, and for. You’ll get the full loop scoop later 
in the book, but not for awhile, so let’s do while for 
now. 

The syntax (not to mention logic) is so simple 
you’re probably asleep already. As long as some 
condition is true, you do everything inside the 
loop block. The loop block is bounded by a pair of 
curly braces, so whatever you want to repeat needs 
to be inside that block. 

The key to a loop is the conditional test. In Java, a 
conditional test is an expression that results in a 
boolean value — in other words, something that is 
either true or false. 

If you say something like, “While iceCreamlnTheTub 
is true, keep scooping”, you have a clear boolean 
test. There either is ice cream in the tub or there 
isn ’t. But if you were to say, “While Bob keep 
scooping”, you don’t have a real test. To make 
that work, you’d have to change it to something 
like, “While Bob is snoring...” or “While Bob is not 
wearing plaid...” 



Simple boolean tests 

You can do a simple boolean test by checking 
the value of a variable, using a comparison operator 
including: 

< (less than) 

> (greater than) 

== (equality) (yes, that’s two equals signs) 

Notice the difference between the assignment 
operator (a single equals sign) and the equals 
operator ( two equals signs). Lots of programmers 
accidentally type = when they want ==. (But not 
you.) 

int x = 4; // assign 4 to x 
while (x > 3) { 

// loop code will run because 

// x is greater than 3 

x = x - 1; // or we'd loop forever 

} 

int z = 27; // 
while (z == 17) { 

// loop code will not run because 
// z is not equal to 17 

} 

you are here ► 
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Java basics 



Dmnlit^uestions 

% Why does everything have 
to be in a class? 



Java is an object-oriented 
(00) language. It's not like the 
old days when you had steam- 
driven compilers and wrote one 
monolithic source file with a pile 
of procedures. In chapter 2 you'll 
learn that a class is a blueprint for 
an object, and that nearly every- 
thing in Java is an object. 

Q? Do I have to put a main in 
every class I write? 

A* 

Nope. A Java program 
might use dozens of classes (even 
hundreds), but you might only 
have one with a main method — 
the one that starts the program 
running. You might write test 
classes, though, that have main 
methods for testing your other 
classes. 



% In my other language I can 
do a boolean test on an integer. 
In Java, can I say something like: 



int x = 1 ; 
while (x) { } 



A- 

- r \ m No. A boolean and an 
integer are not compatible types in 
Java. Since the result of a condi- 
tional test must be a boolean, the 
only variable you can directly test 
(without using a comparison op- 
erator) is a boolean. For example, 
you can say: 

boolean isHot = true; 
while (isHot) { } 



Example of a while loop 

public class Loopy { 

public static void main (String [] args) { 
int x = 1 ; 

System. out .println ("Before the Loop"); 
while (x < 4) { 

System. out .println ("In the loop"); 

System. out .println ("Value of x is " + x); 
x = x + 1; 



System. out .println ("This 



is 



after the loop") ; 



} 

} 

% java Loopy- 
Before the Loop 
In the loop 
Value of x is 1 
In the loop 
Value of x is 2 
In the loop 
Value of x is 3 
This is after the 






loop 






■ Statements end in a semicolon ; 

■ Code blocks are defined by a pair of curly braces { } 

■ Declare an int variable with a name and a type: int x; 

■ The assignment operator is one equals sign = 

■ The equals operator uses two equals signs == 

■ A while loop runs everything within its block (defined by curly 
braces) as long as the conditional test is true. 

■ If the conditional test is false, the while loop code block won’t 
run, and execution will move down to the code immediately 
after ihe loop block. 

■ Put a boolean test inside parentheses: 

while (x == 4) { } 
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dive In A Quick Dip 



Conditional branching 

In Java, an if test is basically the same as the boolean test in a 
while loop - except instead of saying, “ while there’s still beer...”, 
you’ll say, “if there’s still beer...” 

class IfTest { 

public static void main (String [] args) { 
int x = 3; 
if (x == 3) { 

System. out .println ("x must be 3"); 

} 

System. out .println ("This runs no matter what"); 

} 

} 



Systew.out.prinf vs. 
Systew.out.println 

If you've been paying attention (of 
course you have) then you've noticed us 
switching between print and println. 

Did you spot the difference? 

System. oui.println inserts a newline 
(think of print In as printnewline while 
System. out.pr/nf keeps printing to 
the same line. If you want each thing 
you print out to be on its own line, use 
println. If you want everything to stick 
together on one line, use print. 



% java IfTest ^— Code 

x must be 3 

This runs no matter what 



The code above executes the line that prints “x must be 3 ” only 
if the condition (vis equal to 3 ) is true. Regardless of whether 
it’s true, though, the line that prints, “This runs no matter what” 
will run. So depending on the value of x, either one statement 
or two will print out. 

But we can add an else to the condition, so that we can 
say something like, “If there’s still beer, keep coding, else 
(otherwise) get more beer, and then continue on...” 

class IfTest2 { 

public static void main (String [] args) { 
int x = 2; 
if (x == 3) { 

System. out .println ("x must be 3") ; 

} else { 

System. out .println ("x is NOT 3") ; 

} 

System. out .println ("This runs no matter what"); 



OU- 






java IfTest2 
is NOT 3 






This runs no matter what 




Given the output: 

% java DooBee 
DooBeeDooBeeDo 



Fill in the missing code: 

public class DooBee { 
public static void main (Stringf] args) { 
int x = 1; 

while (x < ) { 

System. out. ("Doo'j; 

System.out. ("Bee"); 

x = x + 1 ; 

} 

if ( X == ){ 

System. out. print("Do"); 

} 

} 

} 
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serious Java app 



Coding a Serious Business 
Application 

Let’s put all your new Java skills to good use with 
something practical. We need a class with a main(), an int 
and a String variable, a whileloop, and an if test. A little 
more polish, and you’ll be building that business back- 
end in no time. But before you look at the code on this 
page, think for a moment about how you would code that 
classic children’s favorite, “99 bottles of beer.” 



public class BeerSong { 

public static void main (String [] args) 
int beerNum = 99; 




String word = "bottles"; 



while (beerNum >0) { 



if (beerNum == 1) { 

word = "bottle"; // singular, as in ONE bottle. 

} 



System . out . println (beerNum + " " + word + " of beer on the wall"); 
System . out . println (beerNum + " " + word + " of beer.") ; 

System. out . println ("Take one down."); 

System. out . println ("Pass it around."); 
beerNum = beerNum - 1; 

if (beerNum > 0) { 

System. out . println (beerNum + " " + word + " of beer on the wall"); 
} else { 

System. out . println ("No more bottles of beer on the wall"); 

} // end else 
} // end while loop 
} / / end main method 
} // end class 

There's still one little flaw in our 
code. It compiles and runs, but the 
output isn't 100% perfect. See if 
you can spot the flaw , and fix it. 
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dive In A Quick Dip 



Monday morning at Bob's 



J<3iy 
^°* s ie y means, 



Bob’s alarm clock rings at 8:30 Monday morning, just like every other weekday 
But Bob had a wild weekend, and reaches for the SNOOZE button. 

And that’s when the action starts, and the Java-enabled appliances 
come to life. 

First, the alarm clock sends a message to the coffee maker* “Hey, the geek’s 
sleeping in again, delay the coffee 12 minutes.” 

The coffee maker sends a message to the Motorola™ 

^ toaster, “Hold the toast, Bob’s snoozing.” 

The alarm clock then sends a message to Bob’s 
Nokia Navigator™ cell phone, “Call Bob’s 9 
o’clock and tell him we’re running a little late.” 

Finally, the alarm clock sends a message to 
Sam’s (Sam is the dog) wireless collar, with the too-familiar signal that 
Get the paper, but don’t expect a walk.” 



inside 






A few minutes later, the alarm goes off again. And again Bob 7 
hits SNOOZE and the appliances start chattering. Finally, 
the alarm rings a third time. But just as Bob reaches for the 
snooze button, the clock sends the “jump and bark” signal to Sam’s 
collar. Shocked to full consciousness, Bob rises, grateful that his Java 
skills and a little trip to Radio Shack™ have enhanced the daily 
routines of his life. 

buttcv heve 

His toast is toasted. 

His coffee steams. 

His paper awaits. 

Just another wonderful morning in The Java-Enabled House . 




Java here too 







You can have a Java-enabled home. Stick with a sensible solution using Java, 
Ethernet, and Jini technology. Beware of imitations using other so-called “plug 
and play” (which actually means “plug and play with it for the next three days 
trying to get it to work”) or “portable” platforms. Bob’s sister Betty tried one of 
those others , and the results were, well, not very appealing, or safe. 

Bit of a shame about her dog, too... 



Could this story be true? Yes and no. While there are versions of Java running in de 
vices including PDAs, cell phones ( especially cell phones), pagers, rings, smart cards, 
and more -you might not find a Java toaster or dog collar. But even if you can't 
find a Java-enabled version of your favorite gadget, you can still run it as if it were a 
Java device by controlling it through some other interface (say, your laptop) that is 
running Java. This is known as the Jini surrogate architecture.Yes you can have that 
geek dream home. 

*IP multicast if you're gonna be all picky about protocol 




you are here ► 
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let’s write a program 




public class PhraseOMatic { 

public static void main ( String [] args) { 



OK, so the beer song wasn't really a serious 
business application. Still need something 
practical to show the boss? Check out the 
Phrase-O-Matic code. 



'"her, you iyp . . 

tie Code do it* ^ “ ls lh ^° a* editor / / 

hit ih, T ^ d/l ‘»'-^oo , ei 
n| t the reUr* . ’"'^PpW 

F^e are real, L y ° u see 

y ° Uve ^daStr ln3 h AFTER 



//make three sets of words to choose from. Add your own! 

String [] wordListOne = {"24/7" , "multi - 
Tier" , "30 , 000 foot" , "B-to-B" , "win-win" , "front- 
web-based" /'pervasive" , "smart", "six- 
critical -path" , "dynamic" } ; 



String [] wordListTwo = {"empowered", "sticky", 
"value-added", "oriented", "centric", "distributed", 
"clustered", "branded", "outside-the-box", "positioned", 
"networked", "focused", "leveraged", "aligned", 
"targeted", "shared", "cooperative", "accelerated"}; 

String [] wordListThree = {"process", "tipping- 
point", "solution", "architecture", "core competency", 
"strategy", "mindshare", "portal", "space", "vision", 
"paradigm" , "mission" } ; 



o 



© 



// find out how many words are in each list 

int oneLength = wordListOne. length; 
int twoLength = wordListTwo. length; 
int threeLength = wordListThree. length; 

// generate three random numbers 

int randl = (int) (Math . random ( ) * oneLength); 

int rand2 = (int) (Math . random ( ) * twoLength) ; 

int rand3 = (int) (Math . random ( ) * threeLength) ; 



// now build a phrase 

String phrase = wordListOne [randl] +""+ 
wordListTwo [rand2] + " " + wordListThree [rand3] ; 



© 



// print out the phrase 

System. out.println ("What we need is a 

} 



+ phrase) ; 
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dive In A Quick Dip 



Phrasc'O-Matic 

How it works. 

In a nutshell, the program makes three lists of words, then randomly picks one word 
from each of the three lists, and prints out the result. Don’t worry if you don’t under- 
stand exactly what’s happening in each line. For gosh sakes, you’ve got the whole book 
ahead of you, so relax. This is just a quick look from a 30,000 foot outside-th e-box 
targeted leveraged paradigm. 

The first step is to create three String arrays - the containers that will hold all the 
words. Declaring and creating an array is easy; here’s a small one: 

Stringf] pets = {"Fido", "Zeus", "Bin"}; 

Each word is in quotes (as all good Strings must be) and separated by commas. 



2. For each of the three lists (arrays) , the goal is to pick a random word, so we have 
to know how many words are in each list. If there are 14 words in a list, then we need 
a random number between 0 and 13 (Java arrays are zero-based, so the first word is at 
position 0, the second word position 1, and the last word is position 13 in a 14-element 
array) . Quite handily, a Java array is more than happy to tell you its length. You just 
have to ask. In the pets array, we’d say: 

int x = pets. length; 

and x would now hold the value 3. 



what we need 
here is a... 



pervasive targeted 
process 



J. We need three random numbers. Java ships out-of-the-box, off-the-shelf, shrink- 
wrapped, and core competent with a set of math methods (for now, think of them as 
functions) . The random ( ) method returns a random number between 0 and not- 
quite-1, so we have to multiply it by the number of elements (the array length) in the 
list we’re using. We have to force the result to be an integer (no decimals allowed!) so 
we put in a cast (you’ll get the details in chapter 4) . It’s the same as if we had any float- 
ing point number that we wanted to convert to an integer: 

int x = (int) 24.6; 



T. Now we get to build the phrase, by picking a word from each of the three lists, 
and smooshing them together (also inserting spaces between words). We use the “+” 
operator, which concatenates (we prefer the more technical ‘ smooshes ) the String objects 
together. To get an element from an array, you give the array the index number (posi- 
tion) of the thing you want using: 



String s = pets[0]; // s is now the String "Fido" 
s = s + " " + "is a dog"; // s is now "Fido is a dog" 



► Finally, we print the phrase to the command-line and... voila! Were in marketing. 



dynamic outside- 
the-box tipping- 
point 



smart distributed 
core competency 



24/7 empowered 
mindshare 



30,000 foot win-win 
vision 



six-sigma net- 
worked portal 
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the compiler and the JVM 



Fireside Ctiats 




Tonight’s Talk: The compiler and 
the JVM battle over the question, 
“Who’s more important?” 



The Java Virtual Machine 

What, are you kidding? HELLO. I amjava. 
I’m the guy who actually makes a program 
run. The compiler just gives you a file. That’s 
it. Just a hie. You can print it out and use it 
for wall paper, kindling, lining the bird cage 
what^tw, but the hie doesn’t do anything un- 
less I’m there to run it. 

And that’s another thing, the compiler has 
no sense of humor. Then again, if you had to 
spend all day checking nit-picky little syntax 
violations... 



I’m not saying you’re, like, completely useless. 
But really, what is it that you do? Seriously. I 
have no idea. A programmer could just write 
bytecode by hand, and I’d take it. You might 
be out of a job soon, buddy. 



(I rest my case on the humor thing.) But you 
still didn’t answer my question, what do you 
actually do? 



The Compiler 



I don’t appreciate that tone. 



Excuse me, but without me, what exactly 
would you run? There’s a reason Jawa. was 
designed to use a bytecode compiler, for your 
information. If Java were a purely interpreted 
language, where — at runtime — the virtual 
machine had to translate straight-from-a-text- 
editor source code, a Java program would 
run at a ludicrously glacial pace. Java’s had a 
challenging enough time convincing people 
that it’s finally fast and powerful enough for 
most jobs. 



Excuse me, but that’s quite an ignorant (not 
to mention arrogant ) perspective. While it 
is true that — theoretically — you can run any 
properly formatted bytecode even if it didn’t 
come out of a Java compiler, in practice that’s 
absurd. A programmer writing bytecode by 
hand is like doing your word processing by 
writing raw postscript. And I would appreciate 
it if you would not refer to me as “buddy.” 
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dive In A Quick Dip 



The Java Virtual Machine 



But some still get through! I can throw Class- 
CastExceptions and sometimes I get people 
trying to put the wrong type of thing in an 
array that was declared to hold something 
else, and — 



OK. Sure. But what about security ? Look at all 
the security stuff I do, and you’re like, what, 
checking for semicolons ? Oooohhh big security 
risk! Thank goodness for you! 



Whatever. I have to do that same stuff too , 
though, just to make sure nobody snuck in 
after you and changed the bytecode before 
running it. 



Oh, you can count on it. Buddy. 



The Compiler 

Remember that Java is a strongly-typed lan- 
guage, and that means I can’t allow variables 
to hold data of the wrong type. This is a 
crucial safety feature, and I’m able to stop the 
vast majority of violations before they ever get 
to you. And I also — 



Excuse me, but I wasn’t done. And yes, there 
are some datatype exceptions that can emerge 
at runtime, but some of those have to be 
allowed to support one of Java’s other impor- 
tant features — dynamic binding. At runtime, 
a Java program can include new objects that 
weren’t even known to the original program- 
mer, so I have to allow a certain amount of 
flexibility. But my job is to stop anything that 
would never — could never — succeed at run- 
time. Usually I can tell when something won’t 
work, for example, if a programmer acciden- 
tally tried to use a Button object as a Socket 
connection, I would detect that and thus 
protect him from causing harm at runtime. 

Excuse me, but I am the first line of defense, 
as they say. The datatype violations I previous- 
ly described could wreak havoc in a program 
if they were allowed to manifest. I am also 
the one who prevents access violations, such 
as code trying to invoke a private method, or 
change a method that - for security reasons 
- must never be changed. I stop people from 
touching code they’re not meant to see, 
including code trying to access another class’ 
critical data. It would take hours, perhaps days 
even, to describe the significance of my work. 

Of course, but as I indicated previously, if I 
didn’t prevent what amounts to perhaps 99 % 
of the potential problems, you would grind to 
a halt. And it looks like we’re out of time, so 
we’ll have to revisit this in a later chat. 
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exercise: Code Magnets 




EMRrfsc Code Magnets 




A working Java program is all scrambled up 
on the fridge. Can you rearrange the code 
snippets to make a working Java program 
that produces the output listed below? 
Some of the curly braces fell on the floor 
and they were too small to pick up, so feel 
free to add as many of those as you need! 



Output: 



,, | File Edit Window He~ 




% java Shufflel 
a-b c-d 
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dive In A Quick Dip 




BE th& compiler 




Each of the Java files on this page 
represents a complete source file. 
Your job is to play compiler and 
determine whether each of these 

files will compile. If they 
won’t compile, how 
would you fix them? 



B 

public static void main (String [] args) { 
int x = 5; 
while ( x > 1 ) { 
x = x - 1; 
if ( x < 3) { 

System. out. println( "small x"); 

} 

} 



A 

class Exerciselb { 

public static void main (String [] args) { 
int x = 1; 
while ( x < 10 ) { 
if ( x > 3) { 

System. out. println( "big x"); 

} 

} 

} 



c 

class Exerciselb { 
int x = 5; 
while ( x > 1 ) { 
x = x - 1; 
if ( x < 3) { 

System. out. println( "small x"); 

} 

} 
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puzzle: crossword 




Let's give your right brain something to do. 

It's your standard crossword, but almost all 
of the solution words are from chapter 1 Just 
to keep you awake, we also threw in a few 
(non-Java) words from the high-tech world. 



Across 

4. Command-line invoker 
6. Back again? 

8. Can't go both ways 

9. Acronym for your laptop's power 

12. number variable type 

1 3. Acronym for a chip 

14. Say something 

1 8. Quite a crew of characters 

1 9. Announce a new class or method 
21 . What's a prompt good for? 







1 




2 




3 


4 


5 












6 




















7 


















8 














9 


10 




11 












12 


































13 




14 




15 






16 




























































17 




18 














19 
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Down 

1 . Not an integer (or your boat) 

2. Come back empty-handed 

3. Open house 

5. Things' holders 
7. Until attitudes improve 

1 0. Source code consumer 

11. Can't pin it down 
13. Dept, of LAN jockeys 

15. Shocking modifier 

1 6. Just gotta have one 

1 7. How to get things done 

20. Bytecode consumer 
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dive In A Quick Dip 




Messages 



A short Java program is listed below. One block of the program 
is missing. Your challenge is to match the candidate block of 
code (on the left), with the output that you'd see if the block 
were inserted. Not all the lines of output will be used, and some 
of the lines of output might be used more than once. Draw lines 
connecting the candidate blocks of code with their matching 
command-line output. (The answers are at the end of the chapter). 



class Test { 

public static void main (String [] args) { 
int x = 0 ; 
int y = 0; 
while ( x < 5 ) { 




System. out . print (x + "" + y +" "); 
x = x + 1 ; 

} 

} 

} 



9° es here 



tode 



Candidates: 



Possible output: 



„aUV eatV> 
tabulate 
or\t ot tV* 
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puzzle: Pool Puzzle 




P®®] puzzje 




Your job is to take code snippets from the 
pool and place them into the blank 
ines in the code. You may not use the 
same snippet more than once, and 
you won't need to use all the snip- 
pets. Your goal is to make a class that 
will compile and run and produce the 
output listed. Don't be fooled — this one's 
harder than it looks. 



class PoolPuzzleOne { 

public static void main (String [] args) { 
int x = 0; 

while ( ) { 



if ( x < 1 ) { 



} 



if ( ) { 



Output 

rTiTe""EdiTTvindoT*H^ 



%java PoolPuzzleOne 
a noise 
annoys 
an oyster 



} 

if ( X == 1 ) { 



} 

if ( ) { 



} 

System . out . println {““ ) ; 



Note: Each snippet 
from the pool can be 
used only once! 
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//V 

Exercise Solutions 



dive In A Quick Dip 



Code Magnets: 

class Shufflel { 

public static void main (String [] args ) { 

int x = 3; 
while (x > 0) { 

if (x > 2) { 

System. out .print ( "a" ) ; 

} 

x = x - 1 ; 

System . out . print 

if (x — 2) { 

System. out .print ( "b c"); 

} 

if (x == 1) { 

System. out .print ( "d" ) ; 
x = x - 1 ; 

} 

} 

} 

} 

I File Edit Window Help Poet 



% java Shufflel 
a-b c-d 



class Exerciselb { 

public static void main (String [] args) { 
int x = 1; 
while ( x < 10 ) { 

X : X + 1 ; 
if ( x > 3) { 

System. out. println( "big x"); 

} 

} 

} This will compile and run (no output), but 
} without a line added to the program, it 

would run forever in an infinite while' loop! 



class Foo { 

public static void main (String [] args) { 
int x = 5; 
while ( x > 1 ) { 
x = x - 1; 

B if ( x < 3) { 

System. out. println( "small x") ; 

} 

} This file won't compile without a 
} class declaration, and don't forget 
} the matching curly brace ! 



class Exerciselb { 

public static void main(String [] args) { 

int x = 5; 
while ( x > 1 ) { 
x = x - 1; 

C if ( X < 3) { 

System. out. println( "small x"); 

} 

* The 'while loop code must be in- 
* side a method. It can't just be 
* hanging out inside the class. 
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puzzle answers 




class PoolPuzzleOne { 

public static void main (String [] args) { 
int x = 0; 

while ( X < 4 ) { 

System . out . print("a"); 

if ( X < 1 ) { 

System, out. printC' “); 

} 

System, out. print(V'); 

if ( X > 1 ) { 

System . out . printC' oyster") ; 
x = x + 2; 

} 

if ( X == 1 ) { 

System . out . printC'noys"); 

} 

if ( X < 1 ) { 

System . out . printC oise"); 

} 

System. out .print In ( "" ) ; 

4 _ rFiie*^diTl/vindov7^eip~Cheat^^^~^^^~| 

} 

} 

} 



%java PoolPuzzleOne 
a noise 
annoys 
an oyster 
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class Test { 

public static void main (String [] args) { 
int x = 0; 
int y = 0; 
while ( x < 5 ) { 



System . out . print (x + "" + y +" "); 
x = x + 1; 

} 

} 

} 



Candidates: Possible output: 
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2 classes and objects 



A Trip to Objectville 




I was told there would be objects. In chapter 1, we put all of our code in the 
mainO method. That's not exactly object-oriented. In fact, that's not object-oriented at all. Well, 
we did use a few objects, like the String arrays for the Phrase-O-Matic, but we didn't actually 
develop any of our own object types. So now we've got to leave that procedural world behind, 
get the heck out of main(), and start making some objects of our own. We'll look at what makes 
object-oriented (00) development in Java so much fun. We'll look at the difference between 
a class and an object. We'll look at how objects can give you a better life (at least the program- 
ming part of your life. Not much we can do about your fashion sense). Warning: once you get 
to Objectville, you might never go back. Send us a postcard. 
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once upon a time in Objectville 



Chair Wars 

(or How Objects Can Change Your Life) 







c\oc^ s9 



nee upon a time in a software shop, two 
programmers were given the same spec and told to 
“build it”. The Really Annoying Project Manager 
forced the two coders to compete, 
by promising that whoever delivers 
first gets one of those cool Aeron™ 
chairs all the Silicon Valley guys have. 

Larry, the procedural programmer, and 
Brad, the OO guy, both knew this would 
be a piece of cake. 

Larry, sitting in his cube, thought to 
himself, “What are the things this program 
has to do? What procedures do we need?”. 

And he answered himself , “rotate and 
playSound.” So off he went to build the 
procedures. After all, what is a program if not 
a pile of procedures? 

Brad, meanwhile, kicked back at the cafe 
and thought to himself, “What are the things 
in this program... who are the key players?” He 
first thought of The Shapes. Of course, there 
were other objects he thought of like the User, the Sound, 
and the Clicking event. But he already had a library of code 
for those pieces, so he focused on building Shapes. Read 
on to see how Brad and Larry built their programs, and 
for the answer to your burning question, “So, who got the 
Aeron?” 
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lii Larry's cube 

As he had done a gazillion times before, Larry 
set about writing his Important Procedures. 
He wrote rotate and playSound in no time. 

rotate (shapeNum) { 

// make the shape rotate 360° 

} 

playSound (shapeNum) { 

// use shapeNum to lookup which 
// AIF sound to play, and play it 

} 
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At Brad's laptop at the cafe 

Brad wrote a class for each of the three shapes 



Square 



rotahOl 
if code ro no tate a s 
1 

playSoundl] 1 
if code la play lire / 
.‘i Tor a square 



Cisfe 



iMl{ 
tfooda to rotate a i 
I 

pjgpSoundft ( 
flee® topftylhe 
ft tor a circfe 



i 



Triangle 



rotated { 

tfocdfl to PQtiEe a inarglQ 

\ 

piaySoundi ) ( 

tfooftkijMyiheAFfc 

if tar a mangle 
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Larry thought he'd nailed it. He could almost feel the rolled 
steel of the Aeron beneath his... 



classes and objects 



Put wait! There's been a spec change. 

“OK, technically you were first, Larry,” said the Manager, “but we have to add just one 
tiny thing to the program. It’ll be no problem for crack programmers like you two.” 



“If I had a dime for every time I’ve heard that one”, thought Larry, knowing that spec- 
change-no-problem was a fantasy. “And yet Brad looks strangely serene. What’s up with 
that?” Still, Larry held tight to his core belief that the OO way, while cute, was just 
slow. And that if you wanted to change his mind, you’d have to pry it from his cold, 



what got added to the spec 




Pack in Larry's cube 

The rotate procedure would still work; the code used 
a lookup table to match a shapeNum to an actual 
shape graphic. But playSound would have to change. 
And what the heck is a .hif hie? 

playSound ( shapeNum) { 

// if the shape is not an amoeba, 

// use shapeNum to lookup which 
// AIF sound to play, and play it 
// else 

// play amoeba .hif sound 

} 

It turned out not to be such a big deal, but it still 
made him queasy to touch previously-tested code. Of 
all people, he should know that no matter what the 
project manager says, the spec always changes. 



At Prad's laptop at the beach 



Brad smiled, sipped his margarita, and wrote one 
new class. Sometimes the thing he loved most 
about OO was that he didn’t have to touch code 
he’d already tested and delivered. “Flexibility, 
extensibility,...” he mused, reflecting on the 
benefits of OO. 
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once upon a time in Objectville 



Larry snuck in just moments ahead of Brad. 

(Hah! So much for that foofy OO nonsense) . But the smirk on Larry’s face melted when the 
Really Annoying Project Manager said (with that tone of disappointment), “Oh, no, that’s not 
how the amoeba is supposed to rotate...” 

Turns out, both programmers had written their rotate code like this: 

1) determine the rectangle that surrounds the shape 

2) calculate the center of that rectangle, and rotate the shape around that point. 

But the amoeba shape was supposed to rotate around a point on one end , like a clock hand. 

“I’m toast.” thought Larry, visualizing charred Wonderbread™. “Although, hmmmm. I could 
just add another if/else to the rotate procedure, and then just hard-code the rotation point 
code for the amoeba. That probably won’t break anything.” But the little voice at the back of 
his head said, “Big Mistake. Do you honestly think the spec won’t change again?” 



m 




What the spec conveniently 
forgot to mention 



Pack in Larry's cube 

He figured he better add rotation point arguments 
to the rotate procedure. A lot opcode was affected. 
Testing, recompiling, the whole nine yards all over 
again. Things that used to work, didn’t. 

rotate (shapeNum, xPt, yPt) { 

// if the shape is not an amoeba, 

// calculate the center point 
// based on a rectangle, 

// then rotate 
// else 

// use the xPt and yPt as 
// the rotation point offset 
// and then rotate 

} 
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Amoeba 



At brad's laptop on his lawn 
chair at the Telluride IMuegrass Festival 

Without missing a beat, Brad modified the rotate 
method, but only in the Amoeba class. He never 
touched the tested , working , 
compiled code for the other 
parts of the program. To 
give the Amoeba a rota- 
tion point, he added an 
attribute that all Amoebas 
would have. He modi- 
fied, tested, and delivered 
(wirelessly) the revised 



program during a single 
Bela Fleck set. 



int xPoint 
int yPoint 
rotate() { 

II code to rotate an amoeba 
II using amoeba’s x and y 
} 

playSound() { 

II code to play the new 
II .hit file for an amoeba 
} 
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classes and objects 



So, Prad the 00 guy got the chain right? 

Not so fast. Larry found a flaw in Brad’s approach. And, 
since he was sure that if he got the chair he’d also get Lucy 
in accounting, he had to turn this thing around. 

LARRY: You’ve got duplicated code! The rotate 
procedure is in all four Shape things. 

BRAD: It’s a method , not a procedure. And they’re classes , 
not things. 

LARRY: Whatever. It’s a stupid design. You have to 
maintain four different rotate “methods”. How can that 
ever be good? 

BRAD: Oh, I guess you didn’t see the final design. Let me 
show you how OO inheritance works, Larry. 




What Larry wanted 5 
(figured the chair would impress her) 



Square 




Circle 




Triangle 




Amoeba 


rotate() 




rotate() 




rotate() 




rotateQ 


playSoundQ 




playSoundQ 




playSoundQ 




playSoundQ 



I looked at what all four 
classes have in common. 



o 



They're Shapes, and they all rotate and 
playSound. So I abstracted out the 
common features and put them into a 
new class called Shape. 




Q 



superclass 




You can read this as, “Square inherits from Shape”, 
“Circle inherits from Shape”, and so on. I removed 
rotate() and playSound() from the other shapes, so now 
there’s only one copy to maintain. 

The Shape class is called the superclass of the other four 
classes. The other four are the subclasses of Shape. The 
subclasses inherit the methods of the superclass. In other 
words, if the Shape class has the functionality, then the 
subclasses automatically get that same functionality 



jL 



. subclasses 



Then I linked the other 
four shape classes to 
the new Shape class, 
in a relationship called 
inheritance. 




Square 




Circle 




Triangle 




Amoeba 
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once upon a time in Objectville 



What about the Amoeba rotateO? 



LARRY: Wasn’t that the whole problem here — that the amoeba shape 
had a completely different rotate and playSound procedure? 

BRAD: Method. 

LARRY: Whatever. How can amoeba do something different if 
it “inherits” its functionality from the Shape class? 

BRAD: That’s the last step. The Amoeba class overrides the 
methods of the Shape class. Then at runtime, the JVM knows exactly 
which rotate() method to run when someone tells the Amoeba to rotate 





O 

I made the Amoeba class override 
the rotateO and playSoundO 
methods of the superclass Shape. 

Overriding just means that a 
subclass redefines one of its 
inherited methods when it needs 
to change or extend the behavior 
of that method. 

Overriding methods 



LARRY: How do you “tell” an Amoeba to 
do something? Don’t you have to call the 
procedure, sorry — method, and then tell it 
which thing to rotate? 

BRAD: That’s the really cool thing about OO. 
When it’s time for, say, the triangle to rotate, 
the program code invokes (calls) the rotate () 
method on the triangle object. The rest of the 
program really doesn’t know or care how the 
triangle does it. And when you need to add 
something new to the program, you just write 
a new class for the new object type, so the new 
objects will have their own behavior. 
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classes and objects 



the suspense is killing me. 
Who got the chair? 




Amy from the second floor. 

(unbeknownst to all, the Project 
Manager had given the spec to 
three programmers.) 



What do you like about 00? 

“It helps me design in a more natural way. Things 
have a way of evolving." 

-Joy, 27, software architect 

“Not messing around with code I've already 
tested, just to add a new feature." 

-Brad, 32, programmer 

“I like that the data and the methods that oper- 
ate on that data are together in one class." 

-Josh, 22, beer drinker 

“Reusing code in other applications. When I write 
a new class, I can make it flexible enough to be 
used in something new, later." 

-Chris, 39, project manager 

“I can't believe Chris just said that. He hasn't 
written a line of code in 5 years." 

-Daryl, 44, works for Chris 

“Besides the chair?" 

-Amy, 34, programmer 







Time to pump some neurons. 

You just read a story bout a procedural 
programmer going head-to-head with an 00 
programmer. You got a quick overview of some 
key 00 concepts including classes, methods, and 
attributes. We'll spend the rest of the chapter 
looking at classes and objects (we'll return to 
inheritance and overriding in later chapters). 

Based on what you've seen so far (and what you 
may know from a previous 00 language you've 
worked with), take a moment to think about 
these questions: 

What are the fundamental things you need to 
think about when you design a Java class? What 
are the questions you need to ask yourself? 

If you could design a checklist to use when 
you're designing a class, what would be on the 
checklist? 




wetacogflitive tip 

If you’re stuck on an exercise, try talking about 
it out loud. Speaking (and hearing) activates 
a different part of your brain. Although it 
works best if you have another person to 
discuss it with, pets work too. That’s how 
our dog learned polymorphism. 
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thinking about objects 



When you design a class, think about the objects that 
will be created from that class type. Think about: 



■ things the object knows 

■ things the object does 



ShoppingCart 




Button 




Alarm 


cartContents 


knows 


label 

color 


knows 


alarmTime 

alarmMode 


addToCart() 

removeFromCart() 

checkOutQ 


does 


setColor() 

setLabelf) 

dePressf) 

unDepressQ 


does 


setAlarmTimef) 

getAlarmTimef) 

isAlarmSet() 

snoozef) 



knows 

does 



Things an object knows about itself are called 

■ instance variables 

Things an object can do are called 

■ methods 



instance 

variables 

(state) 

methods 

(behavior) 



Song 



title 

artist 



setTitlef) 

setArtistf) 

play() 



knows 

does 



Things an object knows about itself are called instance 
variables. They represent an object’s state (the data), and 
can have unique values for each object of that type. 

Think of instance as another way of saying object. 

Things an object can do are called methods. When you 
design a class, you think about the data an object will need 
to know about itself, and you also design the methods 
that operate on that data. It’s common for an object to 
have methods that read or write the values of the instance 
variables. For example, Alarm objects have an instance 
variable to hold the alarmTime, and two methods for 
getting and setting the alarmTime. 

So objects have instance variables and methods, but those 
instance variables and methods are designed as part of the 
class. 




Fill in what a television object 
might need to know and do. 





instance 

variables 



methods 
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classes and objects 



What’s the difference between 
a class and an object? 




A class is not an object. 

(but it's used to construct them) 



A class is a blueprint for an object. It tells the 
virtual machine how to make an object of that 
particular type. Each object made from that 
class can have its own values for the 
instance variables of that class. For 
example, you might use the Button 
class to make dozens of different 
buttons, and each button might have 
its own color, size, shape, label, and so on. 




dlass 



Look at it this waV... 



An object is like one entry in your address book. 




£ P 1 1 d n o ^^^43 

u M d j| feed L Uj Srt 10 r t 



> 



One analogy for objects is a packet of unused Rolodex™ cards. 

Each card has the same blank fields (the instance variables). When 
you fill out a card you are creating an instance (object), and the 
entries you make on that card represent its state. 

The methods of the class are the things you do to a particular card; 
getName( ), changeName( ), setName( ) could all be methods for 
class Rolodex. 

So, each card can do the same things (getName( ), changeName( ), 
etc.), but each card knows things unique to that particular card. 
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making objects 



Making your first object 



So what does it take to create and use an object? You need two classes. One 
class for the type of object you want to use (Dog, AlarmClock, Television, 
etc.) and another class to test your new class. The tester class is where you put 
the main method, and in that main() method you create and access objects 
of your new class type. The tester class has only one job: to try outxhe meth- 
ods and variables of your new object class type. 

From this point forward in the book, you’ll see two classes in many of 
our examples. One will be the real class - the class whose objects we 
really want to use, and the other class will be the tester class, which we 
call <whateverYourClassNameIs> TestDrive. For example, if we make a 
Bungee class, we’ll need a BungeeTestDrive class as well. Only the 
<someClassName>T estDrive class will have a main() method, and its sole 
purpose is to create objects of your new type (the not-the-tester class), and 
then use the dot operator (.) to access the methods and variables of the new 
objects. This will all be made stunningly clear by the following examples. 



Write your class 



class Dog { 

int size; 
String breed; 
String name; 






v *iabl es 



a *"e-thod 



void bark ( ) { 

System. out .println ("Ruff ! Ruff! 



DOG 

size 

breed 

name 

barkQ 



The Dot Operator (.) 

The dot operator (.) gives 
you access to an object's 
state and behavior (instance 
variables and methods). 

// make a new object 

Dog d = new Dog(); 

// tell it to bark by using the 
// dot operator on the 
// variable d to call bark() 

d.barkO; 

// set its size using the 
// dot operator 

d.size = 40; 



} 

} 



© Write a tester (TestDrive) class 









\Y\ 'V/ 









class DogTestDrive { 

public static void main (String [] 
// Dog test code goes here 



args) { 



} 



} 



© In your tester, make an object and access 
the objects variables and methods 



class DogTestDrive { 

public static void main ( String [] args) { 

Dog d = new Dog ( ) ; < a 2>og objeti 

d . size = 40;^ we he M () 

b “ k 11 ’ V , , *° ft. Po, 



If you already have some 00 savvy, 
you'll know we're not using encapsulation. 
We'll get there in chapter 4. 
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classes and objects 



Making and testing Movie objects 




class Movie { 

String title; 

String genre; 
int rating; 

void playlt() { 

System. out .println ("Playing the movie"); 

} 

} 

public class MovieTestDrive { 

public static void main (String [] args) { 

Movie one = new Movie ( ) ; 

one . title = "Gone with the Stock" ; 

one . genre = "Tragic" ; 

one. rating = -2; 

Movie two = new Movie ( ) ; 

two. title = "Lost in Cubicle Space"; 

two . genre = "Comedy" ; 

two . rating = 5 ; 

two.playIt() ; 

Movie three = new Movie ( ) ; 
three . title = "Byte Club" ; 

three. genre = "Tragic but ultimately uplifting"; 
three. rating = 127; 

} 




The MovieTestDrive class creates objects (instances) of 
the Movie class and uses the dot operator (.) to set the 
instance variables to a specific value.The MovieTestDrive 
class also invokes (calls) a method on one of the objects. 
Fill in the chart to the right with the values the three 
objects have at the end of mainQ. 



object 1 




object 2 



title 

genre 

rating 



object 3 
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get the heck out of main 



Quick! (ret out of wain! 

As long as you’re in main(), you’re not really in Objectville. It’s fine for a test 
program to run within the main method, but in a true OO application, you 
need objects talking to other objects, as opposed to a static main() method 
creating and testing objects. 



The two uses of wain: 

■ to test your real class 

■ to launch/start your Java application 



A real Java application is nothing but objects talking to other objects. In this 
case, talking means objects calling methods on one another. On the previous 
page, and in chapter 4 , we look at using a main() method from a separate 
TestDrive class to create and test the methods and variables of another class. In 
chapter 6 we look at using a class with a main() method to start the ball rolling 
on a rm/Java application (by making objects and then turning those objects 
loose to interact with other objects, etc.) 

As a ‘sneak preview’, though, of how a real Java application might behave, 
here’s a little example. Because we’re still at the earliest stages of learning Java, 
we’re working with a small toolkit, so you’ll find this program a little clunky 
and inefficient. You might want to think about what you could do to improve 
it, and in later chapters that’s exactly what we’ll do. Don’t worry if some of the 
code is confusing; the key point of this example is that objects talk to objects. 



GameLauncher 




mainfStringD args) 






The Guessing Game 

Summary: 

The guessing game involves a 'game' object and three 'player' objects. The game gen- 
erates a random number between 0 and 9, and the three player objects try to guess 
it. (We didn't say it was a really exciting game.) 

Classes: 

GuessGame . class Player . class GameLauncher . class 

The Logic: 

1 ) The GameLauncher class is where the application starts; it has the main () method. 

2) In the main() method, a GuessGame object is created, and its startGameO method 
is called. 

3) The GuessGame object's startGameO method is where the entire game plays out. 

It creates three players, then "thinks" of a random number (the target for the players 
to guess). It then asks each player to guess, checks the result, and either prints out 
information about the winning player(s) or asks them to guess again. 



GuessGame 



Pi 




startGameO 



i ih ' ih 



h ce 




38 chapter 2 



Head First Java, 2nd Edition. Head First Java, 2nd Edition, ISBN: 0596009208 

Prepared for e.simons@icarin.fiuc.org, Eduard Simons 

Copyright © 2005 Bert Bates and Kathy Sierra. This PDF is made available for personal use only during the relevant subscription term, subject to the Safari Terms of Service. Any other use 
requires prior written consent from the copyright owner. Unauthorized use, reproduction and/or distribution are strictly prohibited and violate applicable laws. All rights reserved. 



classes and objects 



public class GuessGaine 
Player pi; 

Player p2; 

Player p3; 



e 



,t Vr 

f«- ft, ft,,, p W , 



'ey 



public void startGame() 
pi = new Player (); 
p2 = new Player (); 
p3 = new Player (); 




int guesspl = 0; 
int guessp2 = 0; 
int guessp3 = 0; 



. declare three variables io hold the 

ST three guesses the Playevs make 



boolean plisRight = false; 
boolean p2isRight = false; 
boolean p3isRight = false; 



^ — declare thiree variables to hold a true or 
+alsc based o * ibe flayer s answer 



int targetNumber = (int) (Math . random ( ) * 10); 

System. out .println ("I'm thinking of a number between 0 



and 




while (true) { 

System. out .println ("Number to guess is " + targetNumber); 



*»ake a iav-je-t' number -that ibe 
flayers have io ju ess 



p2 ! guess ( ) ; ^ “ 63,1 e3Ch Payer's guessO method 

p3 . guess ( ) ; 



} 



guesspl = pi. number; 

System. out .println ("Player one guessed 



+ guesspl) ; 



guessp2 = p2. number; 

System. out .println ("Player two guessed 



+ guessp2) ; 



guessp3 = p3. number; 

System. out .println ("Player three guessed 



guessp3) ; 



get each player's guess (the result of their 
juessc; method running) by accessing ibe 
hUW »b er variable oi eadb flayer 



if (guesspl == targetNumber) { 
plisRight = true; 

} 

if (guessp2 == targetNumber) { 
p2isRight = true; 

} 

if (guessp3 == targetNumber) { 
p3isRight = true; 

} 



fibedk each players guess to see it it matches 
the target number. If a player is right, 
the* set that player’s variable to be true 
(remember , we set it false by de-fault) 



if (plisRight | | p2isRight | | p3isRight) { 




er one OR player two OR player three is right- 
operator means OR) 



System. out .println ("We have a winner! ") ; 

System. out .println ("Player one got it right? " + plisRight); 
System. out .println ("Player two got it right? " + p2isRight); 
System. out .println ("Player three got it right? " + p3isRight); 
System. out .println ("Game is over.") ; 
break; // game over, so break out of the loop 



} else { 

// we must keep going because nobody got it right! 
System. out .println ("Players will have to try again."); 
} // end if/else 
} / / end loop 
} // end method 
// end class 



°ihi 

Payers i, 



% > the l 0 
' 9 u ess. 



*"°ther ; U ;:: P ^ tie 



39 



Head First Java, 2nd Edition. Head First Java, 2nd Edition, ISBN: 0596009208 

Prepared for e.simons@icarin.fiuc.org, Eduard Simons 

Copyright © 2005 Bert Bates and Kathy Sierra. This PDF is made available for personal use only during the relevant subscription term, subject to the Safari Terms of Service. Any other use 
requires prior written consent from the copyright owner. Unauthorized use, reproduction and/or distribution are strictly prohibited and violate applicable laws. All rights reserved. 



Guessing Game 



Running the Guessing (rame 

public class Player { 

int number =0; // where the guess goes 



public void guess () { 

number = (int) (Math . random ( ) * 10); 
System. out . println ("I ' m guessing " 

+ number) ; 



} 



public class GameLauncher { 

public static void main (String [] args) 
GuessGame game = new GuessGameO; 
game . startGame ( ) ; 



} 



Java takes out the 
Garbage 

Each time an object is created 
in Java, it goes into an area of 
memory known as The Heap. 

All objects — no matter when, where, 
or how they're created - live on the 
heap. But it's not just any old memory 
heap;the Java heap is actually called the 
Garbage-Collectible Heap. When you 
create an object, Java allocates memory 
space on the heap according to how 
much that particular object needs. An 
object with, say, 1 5 instance variables, 
will probably need more space than an 
object with only two instance variables. 
But what happens when you need to 
reclaim that space? How do you get an 
object out of the heap when you're done 
with it? Java manages that memory 
for you! When the JVM can 'see' that an 
object can never be used again, that 
object becomes eligible for garbage 
collection. And if you're running low on 
memory, the Garbage Collector will run, 
throw out the unreachable objects, and 
free up the space, so that the space can 
be reused. In later chapters you'll learn 
more about how this works. 




Output (it will be different each time you run it) 



%java GameLauncher 

I'm thinking of a number between 0 and 9. . . 

Number to guess is 7 

I'm guessing 1 

I'm guessing 9 

I'm guessing 9 

Player one guessed 1 

Player two guessed 9 

Player three guessed 9 

Players will have to try again. 

Number to guess is 7 

I'm guessing 3 

I'm guessing 0 

I'm guessing 9 

Player one guessed 3 

Player two guessed 0 

Player three guessed 9 

Players will have to try again. 

Number to guess is 7 
I'm guessing 7 
I'm guessing 5 
I'm guessing 0 
Player one guessed 7 
Player two guessed 5 
Player three guessed 0 
We have a winner! 

Player one got it right? true 
Player two got it right? false 
Player three got it right? false 
Game is over. 
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classes and objects 



cJuniL'^uestipns 

% What if I need global 
variables and methods? How 
do I do that if everything has to 
go in a class? 



A: 



A: 



First of all, everything 
in Java goes in a class. So the 
constant for pi and the method 
for random ( ) , although both 
public and static, are defined 
within the Math class. And you 
must keep in mind that these 
static (global-like) things are the 
exception rather than the rule 
in Java. They represent a very 
special case, where you don't 
have multiple instances/objects. 



What is a Java program? 
What do you actually deliver ? 



A: 



There isn't a concept of 
'global'variables and methods in 
a Java 00 program. In practical 
use, however, there are times 
when you want a method (or 
a constant) to be available 
to any code running in any 
part of your program. Think 
of the random ( ) method in 
the Phrase-O-Matic app; it's a 
method that should be callable 
from anywhere. Or what about 
a constant like p/7 You'll learn 
in chapter 1 0 that marking 
a method as public and 
static makes it behave much 
like a 'global'. Any code, in any 
class of your application, can 
access a public static method. 
And if you mark a variable as 
public, static, and final 
- you have essentially made a 
globally-available constant. 



Then how is this object- 
oriented if you can still make 
global functions and global 
data? 



A Java program is a pile 
of classes (or at least one class). 

In a Java application, one of 
the classes must have a main 
method, used to start-up the 
program. So as a programmer, 
you write one or more classes. 
And those classes are what you 
deliver. If the end-user doesn't 
have a JVM, then you'll also 
need to include that with 
your application's classes, 
so that they can run your 
program. There are a number 
of installer programs that 
let you bundle your classes 
with a variety of JVM's (say, for 
different platforms), and put it all 
on a CD-ROM. Then the end-user 
can install the correct version of 
the JVM (assuming they don't 
already have it on their machine.) 



Q What if I have a hundred 
classes? Or a thousand? Isn't 
that a big pain to deliver 
all those individual files? 

Can I bundle them into one 
Application Thing ? 




A: 



Yes, it would be a big 
pain to deliver a huge bunch of 
individual files to your end-users, 
but you won't have to. You can 
put all of your application files 
into a Java Archive - a .jar file - 
that's based on the pkzip format. 
In the jar file, you can include 
a simple text file formatted as 
something called a manifest, that 
defines which class in that jar 
holds the main() method that 
should run. 




Wake n 

■ - >■* 



c °okies. 

mr 

9R ■ 



a reci Pe. 
Objects are ( ike 







BULLET POINTS 

Object-oriented programming lets you extend 
a program without having to touch previously- 
tested, working code. 

All Java code is defined in a class. 

A class describes how to make an object of 
that class type. A class is like a blueprint. 
An object can take care of itself; you don’t 
have to know or care how the object does it. 
An object knows things and does things. 
Things an object knows about itself are called 
instance variables. They represent the state 
of an object. 

Things an object does are called methods. 
They represent the behavior of an object. 
When you create a class, you may also want 
to create a separate test class which you’ll 
use to create objects of your new class type. 
A class can inherit instance variables and 
methods from a more abstract superclass. 

At runtime, a Java program is nothing more 
than objects ‘talking’ to other objects. 
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exercise: Be the Compiler 




ExegctSe 



BE the compiler 

Each of the Java files on this page 
represents a complete source file. 
Your job is to play compiler and 

determine whether each of 
these files will compile. 
If they won’t compile, 
how would you fix them, 
and if they do compile, 
what would be their output? 




class TapeDeck { 



boolean canRecord = false; 
void playTape() { 

System. out. println( "tape playing" ) ; 

} 

void recordTape() { 

System. out. println( "tape recording" ) ; 

} 

} 

class TapeDeckTestDrive { 

public static void main (String [] args) { 

t. canRecord = true; 
t.playTape( ); 

if (t. canRecord == true) { 
t.recordTape( ) ; 

} 

} 



B 

class DVDPlayer { 

boolean canRecord = false; 
void recordDVD() { 

System. out .print In ( "DVD recording" ) ; 

} 

} 

class DVDPlayerTestDrive { 

public static void main (String [] args) { 

DVDPlayer d = new DVDPlayer(); 
d. canRecord = true; 
d.playDVD( ) ; 

if (d. canRecord == true) { 
d.recordDVD( ) ; 

} 

} 

} 
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classes and objects 




Code Magnets 

A Java program is all scrambled up on 
the fridge. Can you reconstruct the 
code snippets to make a working Java 
program that produces the output listed 
below? Some of the curly braces fell on 
the floor and they were too small to pick 
up, so feel free to add as many of those 
as you need. 



d.playSnare( ) ; 






% java DrumKitTes tDrive 
bang bang ba-bang 
ding ding da-ding 



DrumKit d = new DrumKit ( ) ; 

booIearTTopHat^txu^ 

boolean snare = true; 



void playSnare ( ) { 

System. out .println( "bang bang ba-bang ), 

} 



public static void main (String [] args) { 
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puzzle: Pool Puzzle 




P^l Puzz]e 




Your job is to take code snippets from 
the pool and place them into the 
blank lines in the code. You may 
use the same snippet more than 
once, and you won't need to use 
all the snippets. Your goal is to 
make classes that will compile and 
run and produce the output listed. 




Bonus Question ! 

If the last line of output was 
24 instead of 10 how would 
you complete the puzzle ? 



public class EchoTestDrive { 

public static void main (String [] args) { 
Echo el = new Echo(); 



int x = 0; 

while ( ) { 

el .hello( ) ; 



if ( ) { 

e2. count = e2. count + 1; 

} 

if ( ) { 

e2. count = e2. count + el. count; 

} 

x = x + 1; 

} 

System . out . println ( e2 . count ) ; 

} 

} 



class { 

int = 0; 

void { 

System. out .println ( "helloooo. . . " ) ; 

} 

} 




Head First Java, 2nd Edition. Head First Java, 2nd Edition, ISBN: 0596009208 

Prepared for e.simons@icarin.fiuc.org, Eduard Simons 

Copyright © 2005 Bert Bates and Kathy Sierra. This PDF is made available for personal use only during the relevant subscription term, subject to the Safari Terms of Service. Any other use 
requires prior written consent from the copyright owner. Unauthorized use, reproduction and/or distribution are strictly prohibited and violate applicable laws. All rights reserved. 




classes and objects 





A bunch of Java components, in full costume, are playing a party 
game, "Who am I?" They give you a clue, and you try to guess who 
they are, based on what they say. Assume they always tell the truth 
about themselves. If they happen to say something that could be true 
for more than one of them, choose all for whom that sentence can 
apply. Fill in the blanks next to the sentence with the names of one or 
more attendees.The first one's on us. 



Tonight's attendees: 

Class Method Object 



Instance variable 



am compiled from a .java file. 

My instance variable values can 
be different from my buddy’s 
values. 



tldss 



I behave like a template. 
I like to do stuff. 



I can have many methods. 

I represent ‘state’. 

I have behaviors. 

I am located in objects. 

I live on the heap. 

I am used to create object instances. 
My state can change. 

I declare methods. 

I can change at runtime. 
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exercise solutions 




ExettciSe 



Exercise Solutions 



Code Magnets: 

class DrumKit { 

boolean topHat = true; 
boolean snare = true; 

void playTopHat() { 

System. out .println( "ding ding da-ding"); 

} 

void playSnare() { 

System. out .println( "bang bang ba-bang" ) ; 

} 

} 

class DrumKitTestDrive { 

public static void main (String [] args ) { 

DrumKit d = new DrumKit(); 
d.playSnare ( ) ; 
d. snare = false; 
d.playTopHat ( ) ; 

if (d. snare == true) { 
d.playSnare ( ) ; 

} 

} 

} 






% java DrumKitTestDrive 


bang 


bang 


ba-bang 


ding 


ding 


da-ding 
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Be the Compiler: 

class TapeDeck { 

boolean canRecord = false; 
void playTape() { 

System. out .println( "tape playing" ) ; 

A > 

void recordTape() { 

System. out .println( "tape recording" ) ; 

} 

} 

class TapeDeckTestDrive { 

public static void main (String [] args) { 

TapeDeck t = new TapeDeck( ); 

t. canRecord = true; 
t.playTape(); 

if (t. canRecord == true) { 
t .recordTape( ) ; 

} 

} 

} 



We've got the template, now we have 
to make an object ! 



class DVDPlayer { 

boolean canRecord = false; 
void recordDVD() { 

System. out .println( "DVD recording" ) ; 

} 

void playDVD ( ) { 

System. out. printlnfDVD playing"); 

} 

} 

class DVDPlayerTestDrive { 

public static void main (String [] args) { 
DVDPlayer d = new DVDPlayer(); 
d. canRecord = true; 
d.playDVD( ) ; 

if (d. canRecord == true) { 
d.recordDVD( ) ; 

} 

} 

} 



The line: d.playDVD( ); wouldn't 
compile without a method I 
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classes and objects 




puzzle Solutions 



Fool Puzzle 

public class EchoTestDrive { 

public static void main (String [] args ) { 
Echo el = new Echo(); 

Echo e2 = new Echo( ); // the correct answer 
- or - 

Echo e2 = el; // is the bonus answer! 

int x = 0 ; 
while ( X < 4 ) { 
el .hello( ) ; 
el.count = el.count + 1; 
if ( x == 3 ) { 

e2. count = e2. count + 1; 

} 

if ( X > 0 ) { 

e2. count = e2. count + el.count; 

} 

x = x + 1; 

} 

System . out . print In ( e2 . count ) ; 

} 

} 



class Echo { 
int Count = 0; 
void hello( ) { 

System. out .print In ( "helloooo. . . " ) ; 

} 

} 



\VliP am I? 



1 am compiled from a .java file. 


dlass 


My instance variable values can be 
different from my buddy’s values. 


objcd-t 


1 behave like a template. 


dl ass 


1 like to do stuff. 


objedt method 


1 can have many methods. 


dlass, objedt 


1 represent ‘state’. 


ms-tande variable 


1 have behaviors. 


objedt, dlass 


1 am located in objects. 


method, ms-tande variable 


1 live on the heap. 


objedt 


1 am used to create object 
instances. 


dlass 


My state can change. 


objedi, ms-taKde variable 


1 declare methods. 


dlass 


1 can change at runtime. 


objedt, ms-taKde variable 



Note: both classes and objects are said to have state and behavior. 
They're defined in the class, but the object is also said to ’have' 
them. Right now, we don't care where they technically live. 



% java EchoTestDrive 
helloooo . . . 
helloooo . . . 
helloooo . . . 
helloooo . . . 

10 
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3 primitives and references 



Know Your Variables 




•^SSSSS^, f- 

■SHW 



'►>£ x; 

S / = X + 3; 



Variables come in two flavors: primitive and reference. So far you've 

used variables in two places — as object state (instance variables), and as local variables 
(variables declared within a method ). Later, we'll use variables as arguments (values sent to a 
method by the calling code), and as return types (values sent back to the caller of the method). 
You've seen variables declared as simple primitive integer values (type int). You've seen 
variables declared as something more complex like a String or an array. But there’s gotta be 
more to life than integers, Strings, and arrays. What if you have a PetOwner object with a Dog 
instance variable? Or a Car with an Engine? In this chapter we'll unwrap the mysteries of Java 
types and look at what you can declare as a variable, what you can put in a variable, and what you 
can do with a variable. And we'll finally see what life is truly like on the garbage-collectible heap. 
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declaring a variable 




declaring a variable 

Java cares about type. It won’t let you do 
something bizarre and dangerous like stuff a 
Giraffe reference into a Rabbit variable — what 
happens when someone tries to ask the so-called 
Rabbit to hop ( ) ? And it won’t let you put a 
floating point number into an integer variable, 
unless you acknowledge to the compiler that you 
know you might lose precision (like, everything 
after the decimal point) . 

The compiler can spot most problems: 

Rabbit hopper = new Giraffe () ; 

Don’t expect that to compile. Thankfully. 

For all this type-safety to work, you must declare 
the type of your variable. Is it an integer? a Dog? 
A single character? Variables come in two flavors: 
primitive and object reference. Primitives hold 
fundamental values (think: simple bit patterns) 
including integers, booleans, and floating point 
numbers. Object references hold, well, references 
to objects (gee, didn’t that clear it up.) 

We’ll look at primitives first and then move 
on to what an object reference really means. 

But regardless of the type, you must follow two 
declaration rules: 



variables must have a type 



Besides a type, a variable needs a name, so that 
you can use that name in code. 



variables must have a name 



int count; 

tyfe 



Note: When you see a statement like: “an object 
of type X”, think of type and class as synonyms. 
(We’ll refine that a little more in later chapters.) 
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primitives and references 



'Td like a double mocha, ho, make it an inf." 



When you think of Java variables, think of cups. Coffee cups, tea cups, giant 
cups that hold lots and lots of beer, those big cups the popcorn comes in at 
the movies, cups with curvy, sexy handles, and cups with metallic trim that 
you learned can never, ever go in the microwave. 

A variable is just a cup. A container. It holds something. 

It has a size, and a type. In this chapter, we’re going to look first at the 
variables (cups) that hold primitives, then a little later we’ll look at cups 
that hold references to objects. Stay with us here on the whole cup analogy — as 
simple as it is right now, it’ll give us a common way to look at things when 
the discussion gets more complex. And that’ll happen soon. 



Primitives are like the cups they have at the coffeehouse. If you’ve been to a 
Starbucks, you know what we’re talking about here. They come in different 
sizes, and each has a name like ‘short’, ‘tali’, and, “I’d like a 
‘grande’ mocha half-caff with extra whipped cream”. 

You might see the cups displayed on the counter, 
so you can order appropriately: 




small short 



grande 






And in Java, primitives come in different sizes, and those sizes 
have names. When you declare a variable in Java, 

must declare it with a specific type. The 
four containers here are for the four 
integer primitives in Java. 



long int short byte 



Each cup holds a value, so for Java primitives, rather than saying, “I’d like a 
tall french roast”, you say to the compiler, “I’d like an int variable with the 
number 90 please.” Except for one tiny difference... in Java you also have to 
give your cup a name. So it’s actually, “I’d like an int please, with the value 
of 2486 , and name the variable height.” Each primitive variable has a fixed 
number of bits (cup size). The sizes for the six numeric primitives in Java 





Primitive Types 

Type Bit Depth Value Range 

boolean and char 



boolean (jvM-spedfic) true or false 
char 16 bits 0 to 65535 

numeric (all are signed) 



integer 




byte 


8 bits 


short 


16 bits 


int 


32 bits 


long 


64 bits 


floating point 


float 


32 bits 


double 


64 bits 



-128 to 127 

-32768 to 
32767 

-2147483648 
to 2147483647 
-huge to huge 

varies 

varies 



Primitive declarations 
with assignments: 

int x; 



x = 234; 



byte b = 89; 
boolean isFun = true; 
double d = 3456.98; 
char c ='f'; 
int z = x; 

boolean isPunkRock; 
isPunkRock = false; 
boolean powerOn; 
powerOn = isFun; 
long big = 3456789; 
float f=32.5f; 
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primitive assignment 



You really don't want to spill that... 

Be sure the value can fit into the variable. 




You can’t put a large value into a 
small cup. 

Well, OK, you can, but you’ll 
lose some. You’ll get, as we say, 
spillage. The compiler tries to 
help prevent this if it can tell 
from your code that something’s 
not going to fit in the container 
(variable/ cup) you’re using. 

For example, you can’t pour an 
int-full of stuff into a byte-sized 
container, as follows: 

int x = 24; 
byte b = x; 

//won' t work ! ! 



Why doesn’t this work, you ask? After all, the value of x is 24 , and 24 is definitely 
small enough to fit into a byte. You know that, and we know that, but all the 
compiler cares about is that you’re trying to put a big thing into a small thing, 
and there’s the possibility of spilling. Don’t expect the compiler to know what the 
value of v is, even if you happen to be able to see it literally in your code. 

You can assign a value to a variable in one of several ways including: 

■ type a literal value after the equals sign ( x= 12 , isGood = true, etc.) 

■ assign the value of one variable to another (x = y) 

■ use an expression combining the two (x = y + 43 ) 

In the examples below, the literal values are in bold italics: 

declare an int named size, assign it the value 32 
declare a char named initial, assign it the value j' 
declare a double named d, assign it the value 456.709 
declare a boolean named isCrazy (no assignment) 
assign the value true to the previously-declared isCrazy 



int size = 32; 
char initial = 'j' ; 
double d = 456 . 709; 
boolean isCrazy; 
isCrazy = true; 
int y = x + 456; 



declare an int named y, assign it the value that is the sum 
of whatever x is now plus 456 




The compiler won't let you put 
a value from a large cup into 
a small one. But what about 
the other way — pouring a 
small cup into a big one? No 
problem . 

Based on what you know 
about the size and type of the 
primitive variables, see if you 
can figure out which of these 
are legal and which aren't. 

We haven't covered all the 
rules yet, so on some of these 
you'll have to use your best 
judgment. Tip: The compiler 
always errs on the side of 
s afety. 

From the following list. Circle 
the statements that would be 
legal if these lines were in a 
single method: 

1 . int x = 34.5; 

2 . boolean boo = x ; 

3 . int g = 17 ; 

4 . int y = g ; 

5 . y = y + 10 ; 

6 . short s ; 

7 . s = y ; 

8 . byte b = 3 ; 

9 . byte v = b ; 

10. short n = 12 ; 

11. v = n ; 

12. byte k = 128; 
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primitives and references 



Pack away from that keyword! 

You know you need a name and a type for your variables. 

You already know the primitive types. 

But what can you use as names? The rules are simple. You 
can name a class, method, or variable according to the 
following rules (the real rules are slightly more flexible, 
but these will keep you safe): 

■ It must start with a letter, underscore (_), or 
dollar sign ($). You can’t start a name with a 
number. 

■ After the first character, you can use numbers as 
well. Just don’t start it with a number. 

■ It can be anything you like, subject to those two 
rules, just so long as it isn’t one of Java’s reserved 
words. 



Java ,s 




Furry Oo9 s 



are keywords (and other things) that the compiler recognizes 
And if you really want to play confuse-a-compiler, then just try 
using a reserved word as a name. 

You’ve already seen some reserved words when we looked at 
writing our first main class: j , 



• ::°:t 

^ d s L L " " 

B- c - 



it'll stick even bette 






static void 



public 

And the primitive types are reserved as well: 

boolean char byte short int long float double 

But there are a lot more we haven’t discussed yet. Even if you don’t 
need to know what they mean, you still need to know you can’t use 
‘em yourself. Do not-under any circumstances-try to memorize these 
now. To make room for these in your head, you’d probably have to 
lose something else. Like where your car is parked. Don’t worry, by 
the end of the book you’ll have most of them down cold. 






This table reserved. 




boolean 


byte 


char 


double 


float 


int 


long 


short 


public^ 


private 


protected 


abstract 


final 


native 


static 


strictfp 


synchronized 


transient 


volatile 


if 


else 


do 


while 


switch 


case 


default 


for 


break 


continue 


assert 


class 


extends 


implements 


import 


instanceof 


interface 


new 


package 


super 


this 


catch 


finally 


try 


throw 


throws 


return 


void 


const 


goto 


enum 



Java’s keywords and other reserved words (in no useful order). If you use these for names, the compiler will be very, very upset. 
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object references 



Controlling your Dog object 



You know how to declare a primitive variable and assign it a 
value. But now what about non-primitive variables? In other 
words, what about objects ? 



■ There is actually no such thing as an object variable. 

■ There’s only an object reference variable. 



Dog d = new Dog() 
d.barkQ; 



\ 



think of this 




- XL:- 



Think o( a Dog 
v-e-f crcndc variable as 
a Dog remote Control. 
You use it to get the 
objedt to do something 
(invoke methods). 



■ An object reference variable holds bits that represent a 
way to access an object. 

■ It doesn’t hold the object itself, but it holds something 
like a pointer. Or an address. Except, in Java we don’t 
really know what is inside a reference variable. We do 
know that whatever it is, it represents one and only one 
object. And the JVM knows how to use the reference to 
get to the object. 



You can’t stuff an object into a variable. We often think of 
it that way... we say things like, “I passed the String to the 
System.out.println() method.” Or, “The method returns a Dog” 
or, “I put a new Foo object into the variable named myFoo.” 

But that’s not what happens. There aren’t giant 
expandable cups that can grow to the size of any 
object. Objects live in one place and one place 
only — the garbage collectible heap! (You’ll 
learn more about that later in this chapter.) 

Although a primitive variable is full of 
bits representing the actual value of the 
variable, an object reference variable is full 
of bits representing a way to get to the 
object. 

You use the dot operator (.) 
on a reference variable to say, 

“use the thing before the dot to 
get me the thing after the dot.” For 
example: 



myDog.bark() ; 



means, “use the object referenced by the variable myDog to 
invoke the bark() method.” When you use the dot operator on 
an object reference variable, think of it like pressing a button 
on the remote control for that object. 
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primitives and references 




byte short int long reference 

8 16 32 64 (bit depth not relevant) 

An object reference is just 
another variable value. 

Something that goes in a cup. 

Only this time, the value is a remote control. 



Primitive Variable 

byte x = 7; 

The bits representing 7 go 
into the variable. (000001 1 1 ). 




Reference Variable 

Dog myDog = new Dog() ; 

The bits representing a way to get to 
the Dog object go into the variable. 

The Dog object itself does not go into 
the variable! 



With primitive variables, the value of the vari- 
able is... the value (5, -26.7, 'a'). 

With reference variables, the value of the 
variable is... bits representing a way to get to 
a specific object. 

You don't know (or care) how any particular 
JVM implements object references. Sure, they 
might be a pointer to a pointer to... but even 
if you know, you still can't use the bits for 
anything other than accessing an object. 




We don’t care how many 1’s and 0’s there are in a reference variable.lt’s up to each 
JVM and the phase of the moon. 



The 3 steps of object 
declaration, creation and 
assignment 




Dog myDog = new Dog() ; 



© Declare a reference 
variable 

Dog myDog = new Dog ( ) ; 

Tells the JVM to allocate space for a 
reference variable, and names that 
variable myDog . The reference variable 
is, forever, of type Dog. In other words, 
a remote control that has buttons to 
control a Dog, but not a Cat or a Button 
or a Socket. 

Q Create an object 

Dog myDog = new Dog() ; 

Tells the JVM to allocate space for a 
new Dog object on the heap (we'll 
learn a lot more about that process, 
especially in chapter 9.) 

Dog object 





o 



Link the object 
and the reference 



Dog myDog — new Dog() ; 

Assigns the new Dog to the reference 
variable myDog. In other words, 

programs the remote control . 




Dog object 
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object references 



fjiereictrerip 

Dumb Questions 

How big is a reference 
variable? 

You don't know. Unless 
you're cozy with someone on the 
JVM's development team, you 
don't know how a reference is 
represented. There are pointers 
in there somewhere, but you 
can't access them. You won't 
need to. (OK, if you insist, you 
might as well just imagine it 
to be a 64-bit value.) But when 
you're talking about memory 
allocation issues, your Big 
Concern should be about how 
many objects (as opposed to 
object references) you're creating, 
and how big they (the objects ) 
really are. 



% So, does that mean that 
all object references are the 
same size, regardless of the size 
of the actual objects to which 
they refer? 



Yep. All references for a 
given JVM will be the same 
size regardless of the objects 
they reference, but each JVM 
might have a different way of 
representing references, so 
references on one JVM may be 
smaller or larger than references 
on another JVM. 



% Can I do arithmetic on a 
reference variable, increment it, 
you know - C stuff? 



Nope. Say it with me again, 
"Java is not C." 
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Java f^Tposedi 

This week’s interview: 
Object Reference 



Head First: So, tell us, what’s life like for an object reference? 

Reference: Pretty simple, really. I’m a remote control and I can be programmed to 
control different objects. 

Head First: Do you mean different objects even while you’re running? Like, can you 
refer to a Dog and then five minutes later refer to a Car? 

Reference: Of course not. Once I’m declared, that’s it. If I’m a Dog remote control 
then I’ll never be able to point (oops my bad, we’re not supposed to say point) I mean refer 
to anything but a Dog. 

Head First: Does that mean you can refer to only one Dog? 

Reference: No. I can be referring to one Dog, and then five minutes later I can refer to 
some other Dog. As long as it’s a Dog, I can be redirected (like reprogramming your remote 
to a different TV) to it. Unless... no never mind. 

Head First: No, tell me. What were you gonna say? 

Reference: I don’t think you want to get into this now, but I’ll just give you the short 
version if I’m marked as final, then once I am assigned a Dog, I can never be repro- 
grammed to anything else but that one and only Dog. In other words, no other object can 
be assigned to me. 

Head First: You’re right, we don’t want to talk about that now. OK, so unless you’re 
final, then you can refer to one Dog and then refer to a different Dog later. Can you ever 
refer to nothing at alt ? Is it possible to not be programmed to anything? 

Reference: Yes, but it disturbs me to talk about it. 

Head First: Why is that? 

Reference: Because it means I’m null, and that’s upsetting to me. 

Head First: You mean, because then you have no value? 

Reference: Oh, null is a value. I’m still a remote control, but it’s like you brought 
home a new universal remote control and you don’t have a TV I’m not programmed to 
control anything. They can press my buttons all day long, but nothing good happens. I 
just feel so... useless. A waste of bits. Granted, not that many bits, but still. And that’s not 
the worst part. If I am the only reference to a particular object, and then I’m set to null 
(deprogrammed), it means that now nobody can get to that object I had been referring to. 

Head First: And that’s bad because... 

Reference: You have to ask? Here I’ve developed a relationship with this object, an 
intimate connection, and then the tie is suddenly, cruelly, severed. And I will never see 
that object again, because now it’s eligible for [producer, cue tragic music] garbage collection. 
Sniff. But do you think programmers ever consider that? Snif. Why, why can’t I be a primi- 
tive? I hate being a reference. The responsibility, all the broken attachments... 
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primitives and references 







°°k ob r 



Book 



Life on the garbage-collectible heap 



Book b = new Book ( ) ; 



Book c = new Book ( ) ; 



Declare two Book reference 
variables. Create two new Book 
objects. Assign the Book objects to 
the reference variables. 

The two Book objects are now living 
on the heap. 

References: 2 



Book 



Objects: 2 



Book d = c; 

Declare a new Book reference variable. 
Rather than creating a new, third Book 
object, assign the value of variable c to 
variable d. But what does this mean? 

It's like saying, "Take the bits in c, make a 
copy of them, and stick that copy into d" 

Both c and d refer to the same 
object. 

The c and d variables hold 
two different copies of the 
same value. Two remotes 
programmed to one TV. 

References: 3 
Objects: 2 




Book 




c = b; 

Assign the value of variable b to 
variable c. By now you know what 
this means. The bits inside variable 
b are copied, and that new copy is 
stuffed into variable c. 

Both b and c refer to the 
same object. 

References: 3 
Objects: 2 
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objects on the heap 



Life and death on the heap 

Book b = new Book ( ) ; 

Book c = new Book ( ) ; 

Declare two Book reference variables. 
Create two new Book objects. Assign 
the Book objects to the reference 
variables. 

The two book objects are now living 
on the heap. 

Active References: 2 
Reachable Objects: 2 




Book 



b = c; 

Assign the value of variable c to variable b. 
The bits inside variable c are copied, and 
that new copy is stuffed into variable b. 
Both variables hold identical values. 

Both b and c refer to the same 
object. Object 1 is abandoned 
and eligible for Garbage Collec- 
tion (GC). 

Active References: 2 
Reachable Objects: 1 
Abandoned Objects: 1 

The first object that b referenced, Object 1 , 
has no more references. It's unreachable. 




Book 



c = null; 

Assign the value null to variable c. 
This makes c a null reference, meaning 
it doesn't refer to anything. But it's still 
a reference variable, and another Book 
object can still be assigned to it. 

Object 2 still has an active 
reference (b), and as long 
as it does, the object is not 
eligible for GC. 

Active References: 1 
null References: 1 
Reachable Objects: 1 
Abandoned Objects: 1 
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primitives and references 



Aw array is like a tray of cops 

© Declare an int array variable. An array variable is 
a remote control to an array object. 

int [ ] nums ; 






© Create a new int array with a length 
of 7 , and assign it to the previously- 
declared int [ ] variable nums 



nums = new int [7] ; 



Give each element in the array 
an int value. 

Remember, elements in an int 
array are just int variables. 



nums [ 0 ] 
nums [ 1 ] 
nums [ 2 ] 
nums [ 3 ] 
nums [ 4 ] 
nums [ 5 ] 
nums [ 6 ] 



6 ; 

19; 

44; 

42; 

10 ; 

20 ; 

1 ; 



int array object (int[]) 



iflT[] Ho - tide that the array itsel-f is objedt> 

eve* though the 1 elements are primitives. 



Arrays arc objects too 

The Java standard library includes 
lots of sophisticated data structures 
including maps, trees, and sets 
(see Appendix B), but arrays are 
great when you just want a quick, 
ordered, efficient list of things. 
Arrays give you fast random 
access by letting you use an index 
position to get to any element in 
the array. 

Every element in an array is just 
a variable. In other words, one of 
the eight primitive variable types 
(think: Large Furry Dog) or a 



reference variable. Anything you 
would put in a variable of that type 
can be assigned to an array element 
of that type. So in an array of type 
int (int[] ), each element can hold 
an int. In a Dog array (Dog[]) each 
element can hold... a Dog? No, 
remember that a reference variable 
just holds a reference (a remote 
control), not the object itself. So 
in a Dog array, each element can 
hold a remote control to a Dog. Of 
course, we still have to make the 
Dog objects... and you’ll see all that 
on the next page. 



Be sure to notice one key thing 
in the picture above - the array is 
an object, even though it’s an array of 
primitives. 

Arrays are always objects, whether 
they’re declared to hold primitives 
or object references. But you can 

have an array object that’s declared 
to hold primitive values. In other 
words, the array object can have 
elements which are primitives, but 
the array itself is never a primitive. 
Regardless of what the array holds, 
the array itself is always an object! 
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an array of objects 



Make an array of Pogs 




Dog array object (Dog[]) 



© Declare a Dog array variable 
Dog [ ] pets ; 



© Create a new Dog array with 
a length of 7, and assign it to 
the previously-declared Dog [ ] 
variable pets 

pets = new Dog [7] ; 



What's missing? 



Dogs! We have an array 
of Dog references, but no 
actual Dog objects ! 



Dog[] 




Dog array object (Dog[]) 



© Create new Dog objects, and 
assign them to the array 
elements. 

Remember, elements in a Dog 
array are just Dog reference 
variables. We still need Dogs! 

pets[0] = new Dog() ; 
pets[l] = new Dog() ; 



--%|harperi your pencil — 



What is the current value of 
pets[2]? 

What code would make 
pets[3] refer to one of the 
two existing Dog objects? 
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primitives and references 





Control yoor Pog 



(with a reference variable) 

Dog fido = new Dog() ; 

fido.name = "Fido"; 

We created a Dog object and 
used the dot operator on the 
reference variable fido to access 
the name variable.* 

We can use the fido reference 
to get the dog to bark() or 
eat() or chaseCatQ. 




fido. bark () ; 



Dog 



fido . chaseCat ( ) ; 



What happens if the Pog is in 
a Pog array? 

We know we can access the Dog’s 
instance variables and methods using 
the dot operator, but on what? 

When the Dog is in an array, we don’t 
have an actual variable name (like 
fido) . Instead we use array notation and 
push the remote control button (dot 
operator) on an object at a particular 
index (position) in the array: 

Dog[] myDogs = new Dog [3] ; 
myDogs [ 0 ] = new Dog ( ) ; 
myDogs [ 0 ]. name = "Fido"; 



myDogs [ 0 ] . bark ( ) ; 



*Yes we know we’re not demonstrating encapsulation here, but we’re 
trying to keep it simple. For now. We’ll do encapsulation in chapter 4. 
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using references 



class Dog { 

String name; 

public static void main (String [] args) { 
// make a Dog object and access it 
Dog dogl = new Dog(); 
dogl .bark ( ) ; 
dogl. name = "Bart"; 

/ / now make a Dog array 
Dog [ ] myDogs = new Dog [3]; 

// and put some dogs in it 
myDogs [0] = new Dog ( ) ; 
myDogs [1] = new Dog ( ) ; 
myDogs [2] = dogl; 

// now access the Dogs using the array 

// references 

myDogs [ 0 ]. name = "Fred"; 

myDogs [ 1 ]. name = "Marge"; 



// Hmmmm. . . what is myDogs [2] 

System. out .print ("last dog's name is ") ; 
System . out . println (myDogs [ 2 ] . name ) ; 



// now loop through the array 
// and tell all dogs to bark 
int x = 0; 

while (x < myDogs . length) { 
myDogs [x] . bark ( ) ; 
x = x + 1; 



a vav.aWtW*’ 



public void bark() { 

System. out .println (name + " says Ruff!"); 

} 

public void eat() { } 

public void chaseCatO { } 



A Pog example 

Dog 

name 

bark() 

eat() 

chaseCatQ 



Output 

r"FMe""Ed^^/Vindo\Ar^eTp""Howr 



%java Dog 
null says Ruff! 
last dog' s name is Bart 
Fred says Ruff! 

Marge says Ruff! 

Bart says Ruff! 



■ Variables come in two flavors: primitive and 
reference. 

■ Variables must always be declared with a name 
and a type. 

■ A primitive variable value is the bits representing 
the value (5, ‘a’, true, 3.1416, etc.). 

■ A reference variable value is the bits 
representing a way to get to an object on the 
heap. 

■ A reference variable is like a remote control. 
Using the dot operator (.) on a reference 
variable is like pressing a button on the remote 
control to access a method or instance variable. 

■ A reference variable has a value of null when 
it is not referencing any object. 

■ An array is always an object, even if the array 
is declared to hold primitives. There is no such 
thing as a primitive array, only an array that 
holds primitives. 
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primitives and references 




BE the compiler 



Each of the Java files on this page 
represents a complete source file. 
Your job is to play compiler and 
determine whether each of these files 
will compile. If they won’t 
compile, how would you 
fix them? 




A 

class Books { 

String title; 

String author; 

} 

class BooksTestDrive { 

public static void main (String [] args) { 

Books [ ] myBooks = new Books [ 3 ] ; 
int x = 0; 

myBooks[0] .title = "The Grapes of Java"; 
myBooks [ 1] .title = "The Java Gatsby"; 
myBooks [2 ] .title = "The Java Cookbook"; 
myBooks [ 0 ]. author = "bob"; 
myBooks [ 1 ]. author = "sue"; 
myBooks [ 2 ] . author = " ian" ; 

while (x < 3) { 

System. out. pr int ( myBooks [x] .title) ; 

Sy stem. out. pr int ( " by "); 

System . out . pr intln ( myBooks [ x ] . author ) ; 
x = x + 1; 

} 

} 



B 

class Hobbits { 

String name; 

public static void main (String [] args) { 

Hobbits [ ] h = new Hobbits [ 3 ] ; 
int z = 0; 

while (z < 4) { 
z = z + 1; 

h[z] = new Hobbits ( ) ; 
h[z].name = "bilbo"; 
if (z == 1) { 

h[z].name = "frodo"; 

} 

if (z == 2) { 

h[z].name = "sam"; 

} 

System.out.print(h[z ] .name + " is a "); 
System. out. println( "good Hobbit name"); 

} 

} 

} 
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exercise: Code Magnets 




Code Magnets 

A working Java program is all scrambled up 
on the fridge. Can you reconstruct the code 
snippets to make a working Java program 
that produces the output listed below? 
Some of the curly braces fell on the floor 
and they were too small to pick up, so feel 
free to add as many of those as you need! 





f 






ref = index [y]; | 




int ref; 
while (y < 4) { 



System. out .println (islands [ref] ) ; 




File Edit Window Help Bikini 



% java TestArrays 
island = Fiji 
island = Cozumel 
island = Bermuda 
island = Azores 
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primitives and references 




P^l puzz]e 




Your job is to take code snippets from 
the pool and place them into the 
blank lines in the code. You may 
use the same snippet more than 
once, and you won't need to use 
all the snippets. Your goal is to 
make a class that will compile and 
run and produce the output listed. 



, vasc a sc ? av 

class Triangle { (So „ £ t.«>^ * e * • , 

double area; , , t \ asS) 

int height; ^ <>* 

int length; 

public static void main (String [] args) { 



ate 

to 



while ( ) { 



.height = (x + 1) * 2; 
.length = x + 4; 



Output 



| File Edit Window Help 


Bermuda 




%java Triangle 






triangle 0 , 


area 


= 4.0 




triangle 1 , 


area 


= 10.0 




triangle 2 , 


area 


= 18.0 




triangle 3 , 


area 


= 




Y = 











Bonus Question! 

For extra bonus points, use snippets 
from the pool to fill in the missing 
output (above). 



System. out .print ( "triangle "+x+", area"); 
System, out .print In ( " = " + .area); 



} 



x = 27; 

Triangle t5 = ta[2]; 
ta[ 2 ] .area = 343 ; 

Sy stem. out. print ( "y = " + y) ; 

System. out .println( " , t5 area = "+ t5.area); 

} 

void setArea() { 

= (height * length) / 2; 

} 



Note: Each snippet 
from the pool can be 
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puzzle: Heap o’ Trouble 




A Heap o' Trouble 

A short Java program is listed to the 
right. When '// do stuff' is reached, some 
objects and some reference variables 
will have been created. Your task is 
to determine which of the reference 
variables refer to which objects. Not all 
the reference variables will be used, and 
some objects might be referred to more 
than once. Draw lines connecting the 
reference variables with their matching 
objects. 

Tip: Unless you're way smarter than us, 
you probably need to draw diagrams 
like the ones on page 55 and 56 of this 
chapter. Use a pencil so you can draw 
and then erase reference links (the 
arrows going from a reference remote 
control to an object). 



class HeapQuiz { 
int id = 0; 

public static void main (String [] args) { 
int x = 0; 

HeapQuiz [ ] hq = new HeapQuiz [5] ; 
while ( x < 3 ) { 



hq [ 


X] 


= new 


hq[ 


X] , 


.id 




x = 


X 


+ 1 


r 


} 










hq 


[3] 


= 


hq [ 


1] 


hq 


[4] 


= 


hq [ 


1] 


hq 


[3] 


= 


null ; 


hq 


[4] 


= 


hq [ 


0] 


hq 


[0] 


= 


hq [ 


3] 


hq 


[3] 


= 


hq [ 


2] 


hq 


[2] 


= 


hq [ 


0] 


// 


do 


stuff 



otyttO 

/ -,vU- no-t 






cier-i 



Reference Variables: 




hq[4] 



HeapQuiz Objects: 
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primitives and references 




Ffe-Mimifc 
Mystery 




The case of the pilfered references 

It was a dark and stormy night. Tawny strolled into the programmers’ bullpen like she 
owned the place. She knew that all the programmers would still be hard at work, and she 
wanted help. She needed a new method added to the pivotal class that was to be loaded into the 
client’s new top-secret Java-enabled cell phone. Heap space in the cell phone’s memory was 
as tight as Tawny’s top, and everyone knew it. The normally raucous buzz in the bullpen fell to 
silence as Tawny eased her way to the white board. She sketched a quick overview of the new 
method’s functionality and slowly scanned the room. “Well boys, it’s cmnch time”, she purred. 
“Whoever creates the most memory efficient version of this method is coming with me to the 
client’s launch party on Maui tomorrow... to help me install the new software.” 

The next morning Tawny glided into the bullpen wearing her short Aloha dress. 
“Gentlemen”, she smiled, “the plane leaves in a few hours, show me what you’ve 
got!”. Bob went first; as he began to sketch his design on the white board Tawny 
said, “Let’s get to the point Bob, show me how you handled updating the list of con- 
tact objects.” Bob quickly drew a code fragment on the board: 



Contact [] ca = new Contact [10]; 
while ( x < 10 ) { // make 10 contact objects 

ca[x] = new Contact (); 
x = x + 1; 



// do complicated Contact list updating stuff with ca 



“Tawny I know we’re tight on memory, but your spec said that we had to be able to access 
individual contact information for all ten allowable contacts, this was the best scheme I could 
cook up”, said Bob. Kent was next, already imagining coconut cocktails with Tawny, “Bob,” 
he said, “your solution’s a bit kludgy don’t you think?” Kent smirked, “Take a look at this 
baby”: 



Contact refc; 

while ( x < 10 ) { // make 10 contact objects 

refc = new Contact (); 
x = x + 1; 

} 

// do complicated Contact list updating stuff with refc 

“I saved a bunch of reference variables worth of memory, Bob-o-rino, so put away your 
sunscreen”, mocked Kent. “Not so fast Kent!”, said Tawny, “you’ve saved a little memory, but 
Bob’s coming with me.”. 

Why did Tawny choose Bob’s method over Kent’s, when Kent’s used less memory? 
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exercise solutions 



/*/ ' ] 



Exercise Solutions 



Code Magnets: 

class TestArrays { 

public static void main (String [] args ) { 
int [] index = new int[4]; 
index[0] = 1; 
index[l] = 3; 
index[2] = 0; 
index[3] = 2; 

String [] islands = new String[4]; 
islands[0] = "Bermuda"; 
islands[l] = "Fiji"; 
islands [2] = "Azores"; 
islands [3] = "Cozumel"; 
int y = 0; 
int ref; 
while (y < 4) { 
ref = index[y]; 

System. out .print ( "island = "); 

System. out .println( islands [ref ] ) ; 
y = y + 1; 

} 

} 

} I File Edit Window Help Bikini 



% java TestArrays 
island = Fiji 
island = Cozumel 
island = Bermuda 
island = Azores 



class Books { 

String title; 

String author; 

} 

class BooksTestDrive { 

public static void main (String [] args) { 
Books [ ] myBooks = new Books [ 3 ] ; 
int x = 0; 

myBooks[0] = new Books(); 
myBooks[l] = new Books(); 
myBooks[2] = new Books(); 

myBooks[0] .title = "The Grapes of Java"; 

myBooksf 1] .title = "The Java Gatsby"; 

myBooks [2] .title = "The Java Cookbook"; 

myBooks [ 0 ]. author = "bob"; 

myBooks [ 1 ]. author = "sue"; 

myBooks [ 2 ]. author = "ian"; 

while (x < 3) { 

System . out . print ( myBooks [ x ] . title ) ; 
System. out. pr int ( " by "); 

System . out . pr intln ( myBooks [ x ] . author ) ; 
x = x + 1; 

} 

} 



class Hobbits { 

String name; 
public static void main (String [] args) { 
Hobbits [] h = new Hobbits[3]; 
int z = - 1 ; 
while (z < 2) { 
z = z + 1; 
h[ z] = new Hobbits ( ) ; 
j h[z].name = "bilbo"; 
if (z == 1) { 

h[z].name = "frodo"; 

} 

if (z == 2) { 

h[z].name = "sam"; 

} 

System.out.print(h[ z] .name + " is a "); 
System. out. println( "good Hobbit name"); 

} 

} 

} 



Remember: arrays start with 
element 0 ! 



Remember: We have to 
actually make the Books 
objects ! 
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primitives and references 




Puzzle Solutions 



class Triangle { 
double area; 
int height; 
int length; 

public static void main (String [] args ) { 

int x = 0; 

Triangle [ ] ta = new Triangle[4]; 

while ( X < 4 ) { 

ta[x] = new Triangle(); 

ta[x] .height = (x + 1) * 2; 

ta[x] . length = x + 4 ; 

ta[x].setArea(); 

System. out .print ( "triangle "+x+" , area"); 
System. out .print In ( " = " + ta[x] . area) ; 
x = x + 1; 

} 

int y = x; 

x = 27; 

Triangle t5 = ta[2]; 
ta[ 2 ] . area = 343 ; 

System. out .print ( "y = " + y); 

System. out .println( " , t5 area = "+ t5.area); 

} 

void setArea( ) { 

area = (height * length) / 2; 

} 



%java Triangle 
triangle 0 , area =4.0 
triangle 1, area = 10.0 
triangle 2, area = 18.0 
triangle 3, area = 28.0 
y = 4, t5 area = 343 



The case of the pilfered references 

Tawny could see that Kent’s method had a serious 
flaw. It’s true that he didn’t use as many reference 
variables as Bob, but there was no way to access any 
but the last of the Contact objects that his method cre- 
ated. With each trip through the loop, he was assign- 
ing a new object to the one reference variable, so the 
previously referenced object was abandoned on the 
heap - unreachable. Without access to nine of the ten 
objects created, Kent’s method was useless. 

(The software was a huge success and the client gave Tawny and Bob an extra week 
in Hawaii. We’d like to tell you that by finishing this book you too will get stuff like that.) 



Reference Variables: HeapQuiz Objects: 




69 



Head First Java, 2nd Edition. Head First Java, 2nd Edition, ISBN: 0596009208 

Prepared for e.simons@icarin.fiuc.org, Eduard Simons 

Copyright © 2005 Bert Bates and Kathy Sierra. This PDF is made available for personal use only during the relevant subscription term, subject to the Safari Terms of Service. Any other use 
requires prior written consent from the copyright owner. Unauthorized use, reproduction and/or distribution are strictly prohibited and violate applicable laws. All rights reserved. 





Head First Java, 2nd Edition. Head First Java, 2nd Edition, ISBN: 0596009208 

Prepared for e.simons@icarin.fiuc.org, Eduard Simons 

Copyright © 2005 Bert Bates and Kathy Sierra. This PDF is made available for personal use only during the relevant subscription term, subject to the Safari Terms of Service. Any other use 
requires prior written consent from the copyright owner. Unauthorized use, reproduction and/or distribution are strictly prohibited and violate applicable laws. All rights reserved. 




4 methods use instance variables 



How Objects Behave 




State affects behavior, behavior affects state. We know that objects 

have state and behavior, represented by instance variables and methods. But until now, we 
haven't looked at how state and behavior are related.\Ne already know that each instance of a 
class (each object of a particular type) can have its own unique values for its instance variables. 
Dog A can have a name "Fido" and a weight of 70 pounds. Dog B is "Killer" and weighs 9 pounds. 
And if the Dog class has a method makeNoiseO, well, don't you think a 70-pound dog barks a 
bit deeper than the little 9-pounder? (Assuming that annoying yippy sound can be considered 
a bark.) Fortunately, that's the whole point of an object — it has behavior that acts on its state. In 
other words, methods use instance variable values. Like, "if dog is less than 1 4 pounds, make 
yippy sound, else..." or "increase weight by 5" Let's go change some state. 
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objects have and behavior 



Remember: a class describes what an 
object knows and what an object does 



A class is the blueprint for an object. When you 
write a class, you’re describing how the JVM 
should make an object of that type. You already 
know that every object of that type can have 
different instance variable values. But what about 
the methods? 

Can every object of that type have different 
method behavior? 

Well... sort of.* 

Every instance of a particular class has the same 
methods, but the methods can behave differently 
based on the value of the instance variables. 

The Song class has two instance variables, title 
and artist. The play() method plays a song, but 
the instance you call play() on will play the song 
represented by the value of the title instance 
variable for that instance. So, if you call the play() 
method on one instance you’ll hear the song 
“Politik”, while another instance plays “Darks tar”. 
The method code, however, is the same. 

void play ( ) { 

soundPlayer . playSound ( title) ; 

} 



Song t2 = new Song() ; 
t2 . setArtist ("Travis") ; 
t2 . setTitle ("Sing") ; 

Song s3 = new Song() ; 

s3 . setArtist ("Sex Pistols"); 






instance 

variables 

(state) 

methods 

(behavior) 




knows 



does 




s3 . setTitle ("My Way") ; 



fljuf *oi the Smatv-a one) 



*Yes, another stunningly clear answer! 
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methods use instance variables 



The size affects the bark 

A small Dog’s bark is different from a big Dog’s bark. 

The Dog class has an instance variable size, that the 
bark() method uses to decide what kind of bark sound 
to make. 



class Dog { 
int size; 

String name; 

void bark() { 

if (size > 60) { 

System. out .println ("Wooof ! Wooof ! ") ; 
} else if (size > 14) { 

System. out .println ("Ruff ! Ruff!") ; 

} else { 

System. out .println ("Yip ! Yip!") ; 




class DogTestDrive { 



public static void main (String [] args) { 
Dog one = new Dog(); 
one. size = 70; 

Dog two = new Dog(); 
two. size = 8; 

Dog three = new Dog(); 
three. size = 35; 



one .bark ( ) ; 
two .bark ( ) ; 
three .bark ( ) ; 



^il^^di^/Vindow^el^Tlaydea^ 



!>java DogTestDrive 



Wooof ! Wooof ! 
Yip! Yip! 

Ruff ! Ruff ! 
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method parameters 



You can send things to a method 

Just as you expect from any programming language, you can pass values into 
your methods. You might, for example, want to tell a Dog object how many 
times to bark by calling: 

d. bark (3) ; 

Depending on your programming background and personal preferences, 
you might use the term arguments or perhaps parameters for the values passed 
into a method. Although there are formal computer science distinctions that 
people who wear lab coats and who will almost certainly not read this book, 
make, we have bigger fish to fry in this book. So you can call them whatever 
you like (arguments, donuts, hairballs, etc.) but we’re doing it like this: 

A method uses parameters. A caller passe s arguments. 

Arguments are the things you pass into the methods. An argument (a value 
like 2 , “Foo”, or a reference to a Dog) lands face-down into a... wait for it... 
parameter. And a parameter is nothing more than a local variable. A variable 
with a type and a name, that can be used inside the body of the method. 

But here’s the important part: If a method takes a parameter, you must pass 
it something. And that something must be a value of the appropriate type. 



Call the bark method on the Dog refer- 
ence, and pass in the value 3 (as the 
argument to the method). 



Dog d = new Dog() ; 
d. bark (3) ; 




The bits representing the int 
value 3 are delivered into the 
bark method. 



\j lint 

void bark (int numOfBarks) 




O The bits land in the numOf Barks 

i 



parameter (an int-sized variable). 



{ 



while (numOfBarks >0) { 

System. out .println ("ruff") ; 

numOfBarks = numOfBarks - 1 

} 



O Use the numOf Barks 

parameter as a variable in 
the method code. 
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methods use instance variables 



You can get things back from a method. 



Methods can return values. Every method is declared with a return 
type, but until now we’ve made all of our methods with a void 
return type, which means they don’t give anything back. 

void go ( ) { 



int giveSecret() { 
return 42 ; 

} 

If you declare a method to return a value, you must 
return a value of the declared type! (Or a value 
that is compatible with the declared type. We’ll get 
into that more when we talk about polymorphism 
in chapter 7 and chapter 8.) 
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} 

But we can declare a method to give a specific type of value 
back to the caller, such as: 




Whatever you say 
you’ll give back, you 
better give back! 






int th< 




life . giveSecret 0 ; 
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multiple arguments 



You can send more than one thing 
to a method 



Methods can have multiple parameters. Separate them 
with commas when you declare them, and separate the 
arguments with commas when you pass them. Most 
importantly, if a method has parameters, you must pass 
arguments of the right type and order. 



Calling a two-parameter method, and sending 
it two arguments. 

void go ( ) { 

TestStuff t = new TestStuff(); 



t . takeTwo ( 12 , 34 ); 




void takeTwo (int x, int y) 
int z = x + y; 






System. out .println ("Total is " + z) ; 



You can pass variables into a method, as long as 
the variable type matches the parameter type. 



void go ( ) { 

int f oo = 7 ; 
int bar = 3; 
t . takeTwo ( f oo , bar ) 



} 




****■**?„ #* , 






W'f 



{ 



void takeTwo (int x, int y) 
int z=x+y; 

System. out .println ("Total is 

} 



+ z) ; 



1 JL Z? It’s tV* san ' e 

wka, i i \ 

the takeTwo *»etW 
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methods use instance variables 



Java is pass-by-value. 
That means pass-by-copy. 










int x = 7 ; 




int 



Declare an int vahaDle and assign it 
the value T. The bit pattern for 7 
goes into the variable named x. 



void go (int z) { 




© Declare a method with an int 
parameter named z. 



£ °py of x 




© Call the goQ method, passing 
the variable x as the argument 
The bits in x are copied, and 
the copy lands in z. 



doesn't 



ev en if 






*• does. 



" 1 9e, 



P 

int 






£ 






a 



0 



if* 1 



int 

void go (int z) { 
z = 0 ; 



} 



© Change the value of z inside 
the method. The value of x 
doesn't change! The argument 
passed to the z parameter was 
only a copy of x. 

The method can't change the 
bits that were in the calling 
variable x. 
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arguments and return values 



fjiereicirerip 

Dumb Questions 

What happens if the argument you want to 
pass is an object instead of a primitive? 

A. 

Jr \ m You'll learn more about this in later chapters, 
but you already knowthe answer. Java passes 
everything by value. Everything. But... value means 
bits inside the variable. And remember, you don't 
stuff objects into variables; the variable is a remote 
control — a reference to an object. So if you pass a 
reference to an object into a method, you're passing 
a copy of the remote control. Stay tuned, though, we'll 
have lots more to say about this. 



^t^-Can a method declare multiple return values? 
Or is there some way to return more than one 
value? 



A- 

^^-Sort of. A method can declare only one return 
value. BUT... if you want to return, say, three int values, 
then the declared return type can be an int array. 
Stuff those ints into the array, and pass it on back. It's 
a little more involved to return multiple values with 
different types; we'll be talking about that in a later 
chapter when we talk about ArrayList. 




Do I have to return the exact type I declared? 



A- 

^\-You can return anything that can be implicitly 
promoted to that type. So, you can pass a byte where 
an int is expected. The caller won't care, because the 
byte fits just fine into the int the caller will use for 
assigning the result. You must use an explicit cast 
when the declared type is smaller than what you're 
trying to return. 



Do I have to do something with the return 
value of a method? Can I just ignore it? 

Java doesn't require you to acknowledge a 
return value. You might want to call a method with 
a non-void return type, even though you don't care 
about the return value. In this case, you're calling 
the method for the work it does inside the method, 
rather than for what the method gives returns. In 
Java, you don't have to assign or use the return value. 
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Reminder: Java 
cares about type! 

You can’t return a Giraffe when 
the return type is declared 
as a Rabbit. Same thing with 
parameters. You can’t pass a 
Giraffe into a method that 
takes a Rabbit. 



rs^4>> 



— BULLET POINTS 

Classes define what an object knows and what an 
object does. 

Things an object knows are its instance variables 
(state). 

Things an object does are its methods (behavior). 

Methods can use instance variables so that objects 
of the same type can behave differently. 

A method can have parameters, which means you 
can pass one or more values in to the method. 

The number and type of values you pass in must 
match the order and type of the parameters 
declared by the method. 

Values passed in and out of methods can be 
implicitly promoted to a larger type or explicitly cast 
to a smaller type. 

The value you pass as an argument to a method 
can be a literal value (2, ‘c’, etc.) or a variable of 
the declared parameter type (for example, x where 
x is an int variable). (There are other things you 
can pass as arguments, but we’re not there yet.) 

A method must declare a return type. A void return 
type means the method doesn’t return anything. 

If a method declares a non-void return type, it must 
return a value compatible with the declared return 
type. 
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methods use instance variables 



Cool things you can do with parameters 
and return types 



Now that we’ve seen how parameters and return types work, it’s 
time to put them to good use: Getters and Setters. If you’re into 
being all formal about it, you might prefer to call them Accessors 
and Mutators. But that’s a waste of perfectly good syllables. 
Besides, Getters and Setters fits the Java naming convention, so 
that’s what we’ll call them. 

Getters and Setters let you, well, get and set things. Instance vari- 
able values, usually. A Getter’s sole purpose in life is to send back, 
as a return value, the value of whatever it is that particular Getter 
is supposed to be Getting. And by now, it’s probably no surprise 
that a Setter lives and breathes for the chance to take an argu- 
ment value and use it to set the value of an instance variable. 



class ElectricGuitar { 



ElectricGuitar 



brand 

numOfPickups 

rockStarUsesIt 



getBrand() 

setBrand() 

getNumOfPickups() 

setNumOfPickups() 

get RockSta r U ses 1 1() 

setRockStarUsesItQ 



MW""* ar \ 

standard! 



f^T 



String brand; 
int numOfPickups ; 
boolean rockStarUsesIt; 



String getBrand ( ) { 

return brand; 

} 

void setBrand (String aBrand) { 
brand = aBrand; 

} 

int getNumOf Pickups ( ) { 

return numOfPickups ; 

} 

void setNumOf Pickups (int num) { 
numOfPickups = num; 

} 

boolean getRockStarUsesIt () { 

return rockStarUsesIt; 

} 

void setRockStarUsesIt (boolean yesOrNo) { 
rockStarUsesIt = yesOrNo; 

} 
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real developers encapsulate 



Encapsulation 



Po it or risk humiliation and 
ridicule. 

Until this most important moment, we’ve 
been committing one of the worst OO 
faux pas (and we’re not talking minor 
violation like showing up without the ‘B’ 
in BYOB). No, we’re talking Faux Pas with 
a capital ‘F’. And ‘P’. 

Our shameful transgression? 

Exposing our data! 

Here we are, just humming along without 
a care in the world leaving our data out 
there for anyone to see and even touch. 

You may have already experienced that 
vaguely unsettling feeling that comes with 
leaving your instance variables exposed. 

Exposed means reachable with the dot 
operator, as in: 

theCat . height = 27; 




Think about this idea of using our remote 
control to make a direct change to the Cat 
object’s size instance variable. In the hands 
of the wrong person, a reference variable 
(remote control) is quite a dangerous 
weapon. Because what’s to prevent: 

theCat . height = 0; \ e t tV* ^aY? CY '- 



This would be a Bad Thing. We need to 
build setter methods for all the instance 
variables, and find a way to force other 
code to call the setters rather than access 
the data directly. 



public void setHeight (int ht) 
if (ht > 9) { ^ 

height = ht; 



} 






tat 



hei 3h t 
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methods use instance variables 



Hide the data 

Yes it is that simple to go from 
an implementation that’s just 
begging for bad data to one 
that protects your data and 
protects your right to modify 
your implementation later. 

OK, so how exactly do you 
hide the data? With the 
public and private 
access modifiers. You’re 
familiar with public-we use 
it with every main method. 

Here’s an encapsulation 
starter rule of thumb (all stan- 
dard disclaimers about rules 
of thumb are in effect) : mark 
your instance variables private 
and provide public getters 
and setters for access control. 
When you have more design 
and coding savvy in Java, you 
will probably do things a little 
differently, but for now, this 
approach will keep you safe. 



Mark instance 
variables private 

Mark getters and 
setters public. 



"Sadly, Bill forgot to 
encapsulate his Cat class and 
ended up with a flat cat." 

(overheard at the water cooler). 




Java £aqp©$«di 



This week’s interview: 

An Object gets candid about encapsulation. 



Head First: What’s the big deal about encapsulation? 

Object: OK, you know that dream where you’re giving a talk to 500 people when you 
suddenly realize- you’re naked? 

Head First: Yeah, we’ve had that one. It’s right up there with the one about the Pilates 
machine and... no, we won’t go there. OK, so you feel naked. But other than being a little 
exposed, is there any danger? 

Object: Is there any danger? Is there any danger ? [starts laughing] Hey, did all you other 
instances hear that, “Is there any danger ?” he asks? [falls on the floor laughing] 

Head First: What’s funny about that? Seems like a reasonable question. 

Object: OK, I’ll explain it. It’s [bursts out laughing again, uncontrollably] 

Head First: Gan I get you anything? Water? 

Object: Whew! Oh boy. No I’m fine, really. I’ll be serious. Deep breath. OK, go on. 
Head First: So what does encapsulation protect you from? 

Object: Encapsulation puts a force-field around my instance variables, so nobody can set 
them to, let’s say, something inappropriate. 

Head First: Can you give me an example? 

Object: Doesn’t take a PhD here. Most instance variable values are coded with certain 
assumptions about the boundaries of the values. Like, think of all the things that would 
break if negative numbers were allowed. Number of bathrooms in an office. Velocity of 
an airplane. Birthdays. Barbell weight. Cell phone numbers. Microwave oven power. 

Head First: I see what you mean. So how does encapsulation let you set boundaries? 

Object: By forcing other code to go through setter methods. That way, the setter method 
can validate the parameter and decide if it’s do-able. Maybe the method will reject it and 
do nothing, or maybe it’ll throw an Exception (like if it’s a null social security number 
for a credit card application), or maybe the method will round the parameter sent in to 
the nearest acceptable value. The point is, you can do whatever you want in the setter 
method, whereas you can’t do anything if your instance variables are public. 

Head First: But sometimes I see setter methods that simply set the value without check- 
ing anything. If you have an instance variable that doesn’t have a boundary, doesn’t that 
setter method create unnecessary overhead? A performance hit? 

Object: The point to setters (and getters, too) is that you can change your mind later, 
without breaking anybody else’s code! Imagine if half the people in your com- 
pany used your class with public instance variables, and one day you suddenly realized, 
“Oops- there’s something I didn’t plan for with that value, I’m going to have to switch to a 
setter method.” You break everyone’s code. The cool thing about encapsulation is that you 
get to change your mind. And nobody gets hurt. The performance gain from using variables 
directly is so miniscule and would rarely — if ever — be worth it. 
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how objects behave 



Encapsulating the 
(roodPog class 



class GoodDog { 







private int size; 

public int getSize() { 
return size; 



public void setSize(int s) 
size = s; 



GoodDog 

size 



getSize( ) 
setSize( ) 
bark( ) 



even U* 

add WW'ty tV,e to °* 

70^3,6^70^^ 

later, vou t~e ba* and *ake a 
method saCer, -Caster, better- 



void bark() { 

if (size > 60) { 

System. out . print In ("Wooof ! Wooof \") ; 
} else if (size > 14) { 

System. out .println ("Ruff ! Ruff ! ") ; 

} else { 

System. out . println ("Yip ! Yip ! " ) ; 



Any place where a 
particular value can 
be used, a method 
call that returns that 
type can be used. 

instead of: 

int x = 3 + 24; 

you can say: 

int x = 3 + one.getSizeQ; 




class GoodDogTestDrive { 

public static void main (String [] args) { 

GoodDog one = new GoodDog (); 
one .setSize(70) ; 

GoodDog two = new GoodDog (); 
two . setSize ( 8 ) ; 

System. out .println ("Dog one: " + one . getSize ( ) ) ; 
System. out .println ("Dog two: " + two . getSize ()) ; 
one .bark ( ) ; 
two . bark ( ) ; 
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methods use instance variables 

How do objects in aw array 
behave? 



Just like any other object. The only difference is 
how you get to them. In other words, how you get 
the remote control. Let’s try calling methods on 
Dog objects in an array. 




Declare and create a Dog array, 
to hold 7 Dog references. 

Dog [ ] pets ; 





Dog array object (Dog[]) 



e 

© 




Call methods on the two Dog 
objects. 

pets[0] .setSize(30) ; 
int x = pets[0] .getSize() ; 
pets[l] .setSize(8) ; 



Create two new Dog objects, 
and assign them to the first 
two array elements. 

pets[0] = new Dog() ; 
pets[l] = new Dog() ; 



Dog[] 



Dog array object (Dog[j) 
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initializing instance variables 



Peclaring and initializing 
instance variables 

You already know that a variable declaration needs at least a name 
and a type: 

int size; 

String name; 

And you know that you can initialize (assign a value) to the 
variable at the same time: 

int size = 420; 

String name = "Donny"; 



But when you don’t initialize an instance variable, what happens 
when you call a getter method? In other words, what is the value of 
an instance variable before you initialize it? 



class PoorDog { 



private int size; / 
private String name;^ 

public int getSize() { 
return size; 

} 

public String getName() { 
return name; 

} 






7 



Mat will these return?? 



Instance variables 
always get a 
default value. If 
you don’t explicitly 
assign a value 
to an instance 
variable, or you 
don’t call a setter 
method, the 
instance variable 
still has a value! 



integers 0 

floating points 0.0 

booleans false 

references null 



} 



public class PoorDogTestDrive { 

public static void main (String [] args) 
PoorDog one = new PoorDog () ; 

System. out .println ("Dog size is " + 
System. out .pr in tin ("Dog name is " + 






Ac* 



me . getSize () ) 
me . getName ( ) ) 



} 



File Edit Window Help CallVet 



% java PoorDogTestDrive 
Dog size is 0 
Dog name is null 
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The difference between instance 
and local variables 



methods use instance variables 



pfc Instance variables are declared 
inside a class but not within a method. 

class Horse { 

private double height = 15.2; 
private String breed; 

/ / more code . . . 

} 



© Local variables are declared within a me thod. 

class AddThing { 
int a; 
int b = 12; 

public int add() { 

int total = a + b; 
return total; 

} 

} 



© 



Local variables MUST be initialized before use! 



class Foo { 

public void go ( ) { 

int X; 

int z = x + 3; 

} 

} 



a et u e -^avaw e , 
wt as sook f r* 
io USfc it. tVve 
jjv-eaks 



File Edit Window Help Yikes 



% javac Foo. java 

Foo. java: 4: variable x might 
not have been initialized 

int z = x + 3; 

1 error A 



Local variables do 
NOT get a default 
value! The compiler 
complains if you 
try to use a local 
variable before 
the variable is 
initialized. 




What about method parameters? 
How do the rules about local variables 
apply to them? 

A- 

Jr \ • Method parameters are virtually the 
same as local variables — they're declared 
inside the method (well, technically they're 
declared in the argument list of the method 
rather than within the body of the method, 
but they're still local variables as opposed to 
instance variables). But method parameters 
will never be uninitialized, so you'll never get 
a compiler error telling you that a parameter 
variable might not have been initialized. 

But that's because the compiler will give 
you an error if you try to invoke a method 
without sending arguments that the method 
needs. So parameters are ALWAYS initialized, 
because the compiler guarantees that 
methods are always called with arguments 
that match the parameters declared for the 
method, and the arguments are assigned 
(automatically) to the parameters. 
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object equality 



Comparing variables (primitives or references) 



Sometimes you want to know if two primitives are the same. That’s easy 
enough, just use the == operator. Sometimes you want to know if two 
reference variables refer to a single object on the heap. Easy as well, just use 
the == operator. But sometimes you want to know if two objects are equal. 

And for that, you need the .equals () method. The idea of equality for 
objects depends on the type of object. For example, if two different String 
objects have the same characters (say, “expeditious”), they are meaningfully 
equivalent, regardless of whether they are two distinct objects on the heap. 
But what about a Dog? Do you want to treat two Dogs as being equal if they 
happen to have the same size and weight? Probably not. So whether two 
different objects should be treated as equal depends on what makes sense for 
that particular object type. We’ll explore the notion of object equality again 
in later chapters (and appendix B), but for now, we need to understand that 
the == operator is used only to compare the bits in two variables. What those 
bits represent doesn’t matter. The bits are either the same, or they’re not. 

To compare two primitives, use the == operator 



Use == to compare 
two primitives, 
or to see if two 
references refer to 
the same object. 

Use the equals() 
method to see 
if two different 
objects are equal. 

(Such as two different 
String objects that both 
represent the characters 
in “Fred”) 



The == operator can be used to compare two variables of any kind, and it 
simply compares the bits. 

if (a == b) {...} looks at the bits in a and b and returns true if the bit pattern 
is the same (although it doesn’t care about the size of the variable, so all the 



extra zeroes on the left end don’t matter) . 

int a = 3; 
byte b = 3; 

if (a == b) { // true } 
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To see if two references are the same (which means they 
refer to the same object on the heap) use the == operator 

Remember, the == operator cares only about the pattern of bits in the 
variable. The rules are the same whether the variable is a reference or 
primitive. So the == operator returns true if two reference variables refer to 
the same object! In that case, we don’t know what the bit pattern is (because 
it’s dependent on the JVM, and hidden from us) but we do know that whatever 
it looks like, it will be the same for two references to a single object. 

Foo a = new Foo ( ) ; 

Foo b = new Foo ( ) ; 

Foo c = a; 

if (a == b) { // 

if (a == c) { // 

if (b == c) { // 



false } 
true } 
false } 



a — — t is true 
a — — b is -false 



** ihe 

fo ttey 
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methods use instance variables 





— Sharpen your pencil _ 

What’s legal? 

Given the method below, which 
of the method calls listed on the 
right are legal? 

Put a checkmark next to the 
ones that are legal. (Some 
statements are there to assign 
values used in the method calls). 



int calcArea(int height, int width) { 
return height * width; 

} 



Java » s 

V TT O 

Make vt Stofi-k 

Roses are red, 

this poem is choppy 

passing by value 

js passing by COPY- 

Oh, «ke you can d^^own. Better yet. 




int a = calcArea (7, 12) 

short c=7; 

calcArea (c, 15) ; 

int d = calcArea(57) ; 

calcArea (2,3) ; 

long t = 42; 

int f = calcArea (t, 17) ; 

int g = calcArea ( ) ; 

calcArea () ; 

byte h = calcArea (4 , 20) 
int j = calcArea (2 , 3 , 5) 
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exercise: Be the Compiler 




BE th& compiler 




Each of the Java files on this page 
represents a complete source file. 
Your job is to play compiler and 
: \ determine whether each of these files 
will compile. If they won’t 
compile, how would you 
fix them, and if they do 
compile, what would be 
their output? 




A 

class XCopy { 

public static void main (String [] args) { 
int orig = 42; 

XCopy x = new XCopy ( ) ; 
int y = x. go (orig) ; 

System. out ,println( orig + " " + y); 

} 

int go (int arg) { 
arg = arg * 2; 
return arg; 

} 

} 
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B 

class Clock { 

String time; 

void setTime( String t) { 
time = t; 

} 

void getTime ( ) { 
return time; 

} 

} 

class ClockTestDrive { 

public static void main (String [] args) { 

Clock c = new Clock(); 

c.setTime( "1245" ) ; 

String tod = c.getTime(); 

System. out .print In ( "time: " + tod); 

} 
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methods use instance variables 




A bunch of Java components, in full costume, are playing a party 
game, "Who am I?" They give you a clue, and you try to guess who 
they are, based on what they say. Assume they always tell the truth 
about themselves. If they happen to say something that could be true 
for more than one guy, then write down all for whom that sentence 
applies. Fill in the blanks next to the sentence with the names of one 
or more attendees. 




Tonight's attendees: 

instance variable, argument, return, getter, setter, 
encapsulation, public, private, pass by value, method 



A class can have any number of these. 
A method can have only one of these. 



This can be implicitly promoted. 



I prefer my instance variables private. 



It really means ‘make a copy’. 



Only setters should update these. 



A method can have many of these. 
I return something by definition. 



I shouldn’t be used with instance variables. 



I can have many arguments. 

By definition, I take one argument. 
These help create encapsulation. 

I always fly solo. 
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puzzle: Mixed Messages 




Mixed 

Messages 



A short Java program is listed to your right. 
Two blocks of the program are missing. 
Your challenge is to match the candidate 
blocks of code (below), with the output 

that you'd see if the blocks were inserted. 

Not all the lines of output will be used, and 
some of the lines of output might be used 
more than once. Draw lines connecting 
the candidate blocks of code with their 
matching command-line output. 



Candidates: 

x < 9 
index < 5 

x < 20 
index < 5 

x < 7 
index < 7 



Possible output: 



14 7 



9 5 



19 1 



14 1 



25 1 



7 7 



public class Mix4 { 
int counter = 0; 

public static void main (String [] args) { 
int count = 0; 

Mix4 [] m4a =new Mix4[20]; 
int x = 0; 

while ( ) { 

m4a[x] = new Mix4(); 

m4a [x] . counter = m4a [x] . counter + 1; 

count = count + 1; 

count = count + m4a [x] .maybeNew (x) ; 
x = x + 1; 



System. out .println (count + " " 

+ m4a [ 1] . counter) ; 



} 



public int maybeNew (int index) { 
if ( } { 

Mix4 m4 = new Mix4 () ; 

m4. counter = m4 . counter + 1; 

return 1; 



return 0; 

} 

} 



x < 19 
index < 1 



20 


1 




20 


5 
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methods use instance variables 




po®! puzzle 




Your job is to take code snippets from the 
pool and place them into the blank lines 
in the code. You may not use the same 
snippet more than once, and you won't 
need to use all the snippets. Your goal 
is to make a class that will compile and 
run and produce the output listed. 



public class Puzzle4 { 

public static void main (String [] args) { 



int y = 1; 
int x = 0; 
int result = 0; 
while (x < 6) { 



y = y * 10; 



} 

x = 6; 

while (x > 0) { 



Output 

I File Edit Window Help BellyFlop 



%java Puzzle4 
result 543345 



Note: Each snippet 
from the pool can be 
used only once! 



result = result + 



} 

System. out .println( "result " + result); 



class 



{ 



int ivar; 



doStuf f ( int 
100) { 




you are here ► 
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puzzle: Five Minute Mystery 




Frve-lvllrwfe 

Mystery 



Fast Times in Stim-City 

When Buchanan jammed his twitch-gun into Jai’s side, Jai froze. Jai knew that Buchanan 
was as stupid as he was ugly and he didn’t want to spook the big guy. Buchanan ordered Jai 
into his boss’s office, but Jai’d done nothing wrong, (lately), so he figured a little chat with 
Buchanan’s boss Leveler couldn’t be too bad. He’d been moving lots of neural- stimmers in 
the west side lately and he figured Leveler would be pleased. Black market stimmers weren’t 
the best money pump around, but they were pretty harmless. Most of the stim-junkies he’d 
seen tapped out after a while and got back to life, maybe just a little less focused than before. 

Leveler ’s ‘office’ was a skungy looking skimmer, but once Buchanan shoved him in, Jai 
could see that it’d been modified to provide all the extra speed and armor that a local boss like 
Leveler could hope for. “Jai my boy”, hissed Leveler, “pleasure to see you again”. “Likewise 
I’m sure...”, said Jai, sensing the malice behind Leveler ’s greeting, “We should be square 
Leveler, have I missed something?” “Ha! You’re making it look pretty good Jai, your volume 
is up, but I’ve been experiencing, shall we say, a little ‘breach’ lately...” said Leveler. 




Jai winced involuntarily, he’d been a top drawer jack-hacker in his day. Anytime someone 
figured out how to break a street-jack’s security, unwanted attention turned toward Jai. “No 
way it’s me man”, said Jai, “not worth the downside. I’m retired from hacking, I just move 
my stuff and mind my own business”. “Yeah, yeah”, laughed Leveler, “I’m sure you’re 
clean on this one, but I’ll be losing big margins until this new jack-hacker is shut 
out!” “Well, best of luck Leveler, maybe you could just drop me here and I’ll go 
move a few more ‘units’ for you before I wrap up today”, said Jai. 

“I’m afraid it’s not that easy Jai, Buchanan here tells me that word is you’re 
current on J37NE”, insinuated Leveler. “Neural Edition? sure I play around a bit, so 
what?”, Jai responded feeling a little queasy. “Neural edition’s how I let the stim-junkies 
know where the next drop will be”, explained Leveler. “Trouble is, some stim-junkie’s stayed 
straight long enough to figure out how to hack into my WareHousing database.” “I need a 
quick thinker like yourself Jai, to take a look at my StimDrop J37NE class; methods, instance 
variables, the whole enchilada, and figure out how they’re getting in. It should..”, “HEY!”, 
exclaimed Buchanan, “I don’t want no scum hacker like Jai nosin’ around my code!” “Easy 
big guy”, Jai saw his chance, “I’m sure you did a top rate job with your access modi.. “Don’t 
tell me - bit twiddler!”, shouted Buchanan, “I left all of those junkie level methods public, 
so they could access the drop site data, but I marked all the critical WareHousing methods 
private. Nobody on the outside can access those methods buddy, nobody!” 



“I think I can spot your leak Leveler, what say we drop Buchanan here off at the comer 
and take a cmise around the block”, suggested Jai. Buchanan reached for his twitch-gun but 
Leveler ’s stunner was already on Buchanan’s neck, “Let it go Buchanan”, sneered Leveler, 
“Drop the twitcher and step outside, I think Jai and I have some plans to make”. 



What did Jai suspect? 

Will he get out of Leveler’s skimmer with all his bones intact? 
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methods use instance variables 






Exercise Solutions 



class Clock { 

String time; 

void setTime( String t) { 
time = t; 

} 

String getTimeO { 
return time; 

} 

} 



class ClockTestDrive { 

public static void main (String [] args) { 
Clock c = new Clock(); 
c .setTime( "1245" ) ; 

String tod = c.getTime(); 

System. out. println( "time: " + tod); 

} 

} 

A Class ‘XCopy’ compiles and runs as it stands ! The 
output is: ‘42 84’. Remember Java is pass by value, (which 
means pass by copy), the variable ‘orig’ is not changed by the 
go( ) method. 



Note: 'Setter' methods have a return 
type by definition. 



A class can have any number of these. 

A method can have only one of these. 

This can be implicitly promoted. 

I prefer my instance variables private. 

It really means ‘make a copy’. 

Only setters should update these. 

A method can have many of these. 

I return something by definition. 

I shouldn’t be used with instance variables 
I can have many arguments. 

By definition, I take one argument. 

These help create encapsulation. 

I always fly solo. 



instance variables, getter, setter, method 
return 

return, argument 

encapsulation 

pass by value 

instance variables 

argument 

getter 

public 

method 

setter 

getter, setter, public, private 
return 
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puzzle answers 



Puzzle Solutions 



Answer to the 5 -minute mystery... 



public class Puzzle4 { 

public static void main (String [] args ) { 
Puzzle4b [ ] obs = new Puzzle4b[6]; 
int y = 1 ; 
int x = 0 ; 
int result = 0; 
while (x < 6) { 

obs[x] = new Puzzle4b( ); 
obs[x] . ivar = y; 
y = y * 10; 
x = x + 1; 

} 

x = 6 ; 

while (x > 0) { 
x = x - 1; 

result = result + obs[x].doStuff(x); 

} 

System. out . println ( "result " + result); 

} 

} 

class Puzzle4b { 
int ivar; 

public int doStuff(int factor) { 
if (ivar > 100) { 
return ivar * factor; 

} else { 

return ivar * (5 - factor); 

y Output 

} ^Rk^Edj^Windo^Help^ellyRof^^^l 



% java Puzzle4 
result 543345 



Jai knew that Buchanan wasn’t the sharpest 
pencil in the box. When Jai heard Buchanan 
talk about his code, Buchanan never mentioned 
his instance variables. Jai suspected that 
while Buchanan did in fact handle his methods 
correctly, he failed to mark his instance variables 
private. That slip up could have easily cost 
Leveler thousands. 



Candidates: 



Possible output: 



x < 9 
index < 5 



x < 20 
index < 5 



x < 7 
index < 7 




x < 19 




20 1 


index < 1 




20 5 
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5 writing a program 



Extra-Strength Methods 




Let’s put some muscle in our methods. We dabbled with variables, played 

with a few objects, and wrote a little code. But we were weak. We need more tools. Like 
operators. We need more operators so we can do something a little more interesting than, say, 
bark. And loops. We need loops, but what's with the wimpy while loops? We need for loops 
if we're really serious. Might be useful to generate random numbers. And turn a String 
into an int, yeah, that would be cool. Better learn that too. And why don't we learn it all by 
building something real, to see what it's like to write (and test) a program from scratch. Maybe 
a game, like Battleships. That's a heavy-lifting task, so it'll take two chapters to finish. We'll build 
a simple version in this chapter, and then build a more powerful deluxe version in chapter 6. 
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building a real game 



Let's build a Pattleship-style 
game: "Sink a Pot Com" 



It’s you against the computer, but unlike the real 
Battleship game, in this one you don’t place any ships 
of your own. Instead, your job is to sink the computer’s 
ships in the fewest number of guesses. 

Oh, and we aren’t sinking ships. We’re killing Dot 
Corns. (Thus establishing business relevancy so you can 
expense the cost of this book) . 

Goal: Sink all of the computer’s Dot Corns in the fewest 
number of guesses. You’re given a rating or level, based 
on how well you perform. 

Setup: When the game program is launched, the 
computer places three Dot Corns on a virtual 7x7 
grid. When that’s complete, the game asks for your first 
guess. 



How you play: We haven’t learned to build a GUI yet, so 
this version works at the command-line. The computer 
will prompt you to enter a guess (a cell), that you’ll type 
at the command-line as “A 3 ”, “C 5 ”, etc.). In response 
to your guess, you’ll see a result at the command- 
line, either “Hit”, “Miss”, or “You sunk Pets.com” (or 
whatever the lucky Dot Com of the day is) . When 
you’ve sent all three Dot Corns to that big 404 in the 
sky, the game ends by printing out your rating. 
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You’re going to build the 
Sink a Dot Com game, with 
a 7 x 7 grid and three 
Dot Corns. Each Dot Com 
takes up three cells. 



part of a game interaction 



file Edit Window Help Sell 






| 


% java 


DotComBust 






Enter 


a 


guess 


A3 






miss 












Enter 


a 


guess 


B2 






miss 












Enter 


a 


guess 


C4 






miss 












Enter 


a 


guess 


D2 






hit 












Enter 


a 


guess 


D3 






hit 












Enter 


a 


guess 


D4 






Ouch! 


You sunk 


Pets . com 


: ( 




kill 












Enter 


a 


guess 


B4 






miss 












Enter 


a 


guess 


G3 






hit 












Enter 


a 


guess 


G4 






hit 












Enter 


a 


guess 


G5 






Ouch! 


You sunk 


AskMe . com 
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writing a program 



First a high-level design 

We know we’ll need classes and methods, but what 
should they be? To answer that, we need more 
information about what the game should do. 

First, we need to figure out the general flow of the 
game. Here’s the basic idea: 



User starts the game 

Game creates three Dot Corns 

>:j Game places the three Dot 
Corns onto a virtual grid 



Same play begins 

Repeat the following until there are 
no more Dot Corns: 



c 



o 

o 



Prompt user for a guess 
("A2", "CO", etc.) 



Check the user guess against 
all Dot Corns to look for a hit, 
miss, or kill. Take appropri- 
ate action: if a hit, delete cell 
(A2, D4, etc.). If a kill, delete 
Dot Com. 



Same finishes 

Give the user a rating based on 
the number of guesses. 



Now we have an idea of the kinds of things the 
program needs to do. The next step is figuring 
out what kind of objects we’ll need to do the 
work. Remember, think like Brad rather than 
Larry; focus first on the things in the program 
rather than the procedures. 




Whoa. A real flow chart. 
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a simpler version of the game 



The "Simple Pot Com Came" 

a gentler introduction 

It looks like we’re gonna need at least two classes, a 
Game class and a DotCom class. But before we build 
the full monty Sink a Dot Com game, we’ll start with 
a stripped-down, simplified version, Simple Dot Com 
Game. We’ll build the simple version in this chapter, 
followed by the deluxe version that we build in the 
next chapter. 

Everything is simpler in this game. Instead of a 2 -D 
grid, we hide the Dot Com in just a single row. And 
instead of three Dot Corns, we use one. 



O Ga me starts, and creates ONE DotCom 
and gives it a location on three cells in 
the single row of seven cells. 

Instead of "A2", "C4", and so on, the 
locations are just integers (for example: 
1,2,3 are the cell locations in this 
picture: 




0 1 2 3 4 5 6 



The goal is the same, though, so the game still needs 
to make a DotCom instance, assign it a location 
somewhere in the row, get user input, and when all 
of the DotCom’s cells have been hit, the game is over. 
This simplified version of the 
game gives us a big head start 
on building the full game. 

If we can get this small one 
working, we can scale it up to 
the more complex one later. 

In this simple version, the 
game class has no instance 
variables, and all the game 
code is in the main() method. 

In other words, when the 
program is launched and 
main() begins to run, it will 



consecutive cells on the single virtual 

seven-cell row) , ask the user for a guess, check the 

guess, and repeat until all three cells have been hit. 



Q 



simoleDotCornGame 1 5 








SimpleDotCom 


void main 


int [] locationCells 1 

int numOfHits I 


1 

three 


String checkYourselffString guess) | 
void setLocationCellsfintfl loc) 1 



Keep in mind that the virtual row is... virtual. In other 
words, it doesn’t exist anywhere in the program. As 
long as both the game and the user know that the 
DotCom is hidden in three consecutive cells out of a 
possible seven (starting at zero), the row itself doesn’t 
have to be represented in code. You might be tempted 
to build an array of seven ints and then assign the 
DotCom to three of the seven elements in the array, 
but you don’t need to. All we need is an array that 
holds just the three cells the DotCom occupies. 



Game play begins. Prompt user for 
a guess, then check to see if it hit 
any of the DotCom's three cells. 

If a hit, increment the numOf Hits 
variable. 

Game finishes when all three cells have 
been hit (the numOf Hits variable val- 
ue is 3), and tells the user how many 
guesses it took to sink the DotCom. 



A complete game interaction 

File Edit Window Help Destroy 



%java SimpleDotComGame 
enter a number 2 
hit 

enter a number 3 
hit 

enter a number 4 
miss 

enter a number 1 
kill 

You took 4 guesses 
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writing a program 



developing a Class 

As a programmer, you probably have a methodology/ 
process/approach to writing code. Well, so do we. Our 
sequence is designed to help you see (and learn) what 
we’re thinking as we work through coding a class. It 
isn’t necessarily the way we (or you) write code in the 
Real World. In the Real World, of course, you’ll follow 
the approach your personal preferences, project, or 
employer dictate. We, however, can do pretty much 
whatever we want. And when we create a Java class as a 
“learning experience”, we usually do it like this: 

□ Figure out what the class is supposed to do. 

□ List the instance variables and methods. 

□ Write prepcode for the methods. (You'll see 
this in just a moment.) 



The three things well write for 
each class: 



prep code 



test code 



real code 



This bar is displayed on the next set of pages to tell 
you which part you're working on. For example, if you 
see this picture at the top of a page, it means you're 
working on prepcode for the SimpleDotCom class. 

SimpleDotCom class 



prep code 



test code 



real code 



prep code 

A form of pseudocode, to help you focus on 
the logic without stressing about syntax. 



□ Write test code for the methods. 

□ Implement the class. 

□ Test the methods. 



test code 

A class or methods that will test the real code 
and validate that it’s doing the right thing. 



□ Debug and reimplement as needed. 

□ Express gratitude that we don't have to test 
our so-called learning experience app on 
actual live users. 






Flex those dendrites. 

How would you decide which class or classes 
to build first, when you're writing a program? 
Assuming that all but the tiniest programs 
need more than one class (if you're following 
good 00 principles and not having one class 
do many different jobs), where do you start? 



real code 
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SimpleDotCom class 




prep code test code 



SimpleDotCom 

int [] locationCells 
int numOfHits 

String checkYourself(String guess) 
void setLocationCells(int[] loc) 



You’ll get the idea of how prepcode (our version of pseudocode) works as you 
read through this example. It’s sort of half-way between real Java code and a plain 
English description of the class. Most prepcode includes three parts: instance 
variable declarations, method declarations, method logic. The most important 
part of prepcode is the method logic, because it defines what has to happen, 
which we later translate into how , when we actually write the method code. 

DECLARE an int array to hold the location cells. Call it locationCells. 

DECLARE an int to hold the number of hits. Call it numOfHits and SET it to 0. 



DECLARE a checkYourself() method that takes a String for the user's guess (“ I ",“3", etc.), 
checks it, and returns a result representing a “hit”, “miss", or “kill”. 



DECLARE a setLocationCells() setter method that takes an int array (which has the three cell 
locations as ints (2,3,4, etc.). 



METHOD: String checkYourself(String userCuess) 

GET the user guess as a String parameter 
CONVERT the user guess to an int 

REPEAT with each of the location cells in the int array 

// COMPARE the user guess to the location cell 

IF the user guess matches 

INCREMENT the number of hits 
// FIND OUT if it was the last location cell: 

IF number of hits is 3, RETURN “kill” as the result 

ELSE it was not a kill, so RETURN“hit” 

END IF 

ELSE the user guess did not match, so RETURN “miss” 

END IF 

END REPEAT 

END METHOD 



METHOD: void setLocationCells(int[] cellLocations) 

GET the cell locations as an int array parameter 

ASSIGN the cell locations parameterto the cell locations instance variable 
END METHOD 
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prep code test code 



writing a program 



Writing the method 
implementations 

let's write the real 
method code now, and get 
this puppy working. 

Before we start coding the 
methods, though, let’s back 
up and write some code to 
test the methods. That’s right, 
we’re writing the test code 
before there’s anything to test! 

The concept of writing 
the test code first is one of 
the practices of Extreme 
Programming (XP) , and 
it can make it easier (and 
faster) for you to write your 
code. We’re not necessarily 
saying you should use XP, 
but we do like the part about 
writing tests first. And XP just 
sounds cool. 




Oh my! For a minute ; 
there I thought you 
weren't gonna write your 
test code first. Whoo! 
Don't scare me like that 



Extreme Programming (XP) 



Extreme Programming(XP) is a newcomer to the software 
development methodology world. Considered by many 
to be "the way programmers really want to work" XP 
emerged in the late 90's and has been adopted by 
companies ranging from the two-person garage shop 
to the Ford Motor Company.The thrust of XP is that the 
customer gets what he wants, when he wants it, even 
when the spec changes late in the game. 

XP is based on a set of proven practices that are all 
designed to work together, although many folks do pick 
and choose, and adopt only a portion of XP's rules. These 
practices include things like: 

Make small, but frequent, releases. 

Develop in iteration cycles. 



Don't put in anything that's not in the spec (no matter 
how tempted you are to put in functionality "for the 
future"). 

Write the test code first. 

No killer schedules; work regular hours. 

Refactor (improve the code) whenever and wherever you 
notice the opportunity. 

Don't release anything until it passes all the tests. 

Set realistic schedules, based around small releases. 

Keep it simple. 

Program in pairs, and move people around so that 
everybody knows pretty much everything about the code. 
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SimpleDotCom class 



prep code test code 



Writing test code for the SiwplePotCow class 

We need to write test code that can make a SimpleDotCom object 
and run its methods. For the SimpleDotCom class, we really 
care about only the checkYourself() method, although we z^Z/have 
to implement the setLocationCells() method in order to get the 
checkYourselfO method to run correctly. 

Take a good look at the prepcode below for the checkYourselfO 
method (the setLocationCells() method is a no-brainer setter method, 
so we’re not worried about it, but in a ‘real’ application we might 
want a more robust ‘setter’ method, which we would want to test). 

Then ask yourself, “If the checkYourselfO method were 
implemented, what test code could I write that would prove to me 
the method is working correctly?” 



Here's what we should test: 

1 . Instantiate a SimpleDotCom object. 

2. Assign it a location (an array of 3 ints, like 
{2,3,4}). 

3. Create a String to represent a user guess 
(“2”, “0”, etc.). 

4. Invoke the checkYourselfO method pass- 
ing it the fake user guess. 

5. Print out the result to see if it’s correct 
(“passed” or “failed”). 

IF number of hits is 3, RETURN “Kill" as the result 
ELSE it was not a kill, so RETURN“Hit’’ 

END IF 

ELSE the user guess did not match, so RETURN “Miss” 

END IF 
END REPEAT 
END METHOD 



Pased on this prepcode: 

METHOD String checkYourself(String userGuess) 

GET the user guess as a String parameter 
CONVERT the user guess to an int 
REPEAT with each of the location cells in the int array 
// COMPARE the user guess to the location cell 
IF the user guess matches 

INCREMENT the number of hits 
// FIND OUT if it was the last location cell: 
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writing a program 



prep code test code 

fjiereiqrerio 

Dumb Questions 

Maybe I'm missing some- 
thing here, but how exactly do 
you run a test on something 
that doesn't yet exist!? 



A:n 



L-You don't. We never said 
you start by running the test; 
you start by writing the test. At 
the time you write the test code, 
you won't have anything to run 
it against, so you probably won't 
be able to compile it until you 
write 'stub' code that can com- 
pile, but that will always cause 
the test to fail (like, return null.) 

Q? Then I still don't see the 
point. Why not wait until the 
code is written, and then whip 
out the test code? 



A : i 



L-The act of thinking through 
(and writing) the test code helps 
clarify your thoughts about what 
the method itself needs to do. 

As soon as your implementation 
code is done, you already have 
test code just waiting to validate 
it. Besides, you know if you don't 
do it now, you'll never do it. 
There's always something more 
interesting to do. 

Ideally, write a little test code, 
then write only the implementa- 
tion code you need in order to 
pass that test.Then write a little 
more test code and write only 
the new implementation code 
needed to pass that new test. At 
each test iteration, you run all 
the previously-written tests, so 
that you always prove that your 
latest code additions don't break 
previously-tested code. 



test code for the SimplePotCom class 



public class SimpleDotComTestDrive { 



£&>•«> 



public static void main (String [] args) { . • \ 

SimpleDotCom dot = new SimpleDotCom() ; 

^. a rii a 3V d ^ 



int[] locations = {2,3,4}; 
dot. setLocationCells (locations) ; 






String userGuess = "2";, 



make a take 

usev 



•hvokc ik* / / 
"•'hod 0h 

* M 



String result = dot . checkYourself (userGuess) ; 

String testResult = "failed"; £ ^ e ^Yoursel-fO 

method or, ih e doi torn 

if (result. equals ("hit") ) { faig 



testResult = "passed" ; 



he fake y*e« (2-) yves 

batka u W.t’,«tsxorkm5 



System. out .pr in tin (testResult) ; 






o he iesi result 
Wd or failed") * 



— Sharpen your pencil 

^ In the next coupl 



^ In the next couple of pages we implement the SimpleDotCom class, 
and then later we return to the test class. Looking at our test code 
above, what else should be added? What are we not testing in this 
code, that we should be testing for? Write your ideas (or lines of 
code) below: 



you are here ► 103 



Head First Java, 2nd Edition. Head First Java, 2nd Edition, ISBN: 0596009208 

Prepared for e.simons@icarin.fiuc.org, Eduard Simons 

Copyright © 2005 Bert Bates and Kathy Sierra. This PDF is made available for personal use only during the relevant subscription term, subject to the Safari Terms of Service. Any other use 
requires prior written consent from the copyright owner. Unauthorized use, reproduction and/or distribution are strictly prohibited and violate applicable laws. All rights reserved. 




SimpleDotCom class 

prep code test code 

The checkYoorself 0 method 

There isn’t a perfect mapping from prepcode to javacode; you’ll see a few 
adjustments. The prepcode gave us a much better idea of what the code needs to 
do, and now we have to find the Java code that can do the how. 

In the back of your mind, be thinking about parts of this code you might want 
(or need) to improve. The numbers © are for things (syntax and language 
features) you haven’t seen yet. They’re explained on the opposite page. 




GET the user 
guess 

CONVERT 

the user guess to 

an int 



REPEAT with 
each cell in the int 
array 

IF the user guess 
matches 



INCREMENT 

the number of 
hits 



//FIND OUT if 

it was the last cell 

IF number of hits 
is 3, 

RETURN kill 
as the result 

ELSE it was 
not a kill, so 

RETURN hit 

ELSE 

RETURN 

“miss” 



public String checkYour self (String stringGuess) { 

int guess = Intege^parselnt (stringGuess) ; { — i living 

' to d* ihf 

String result = "miss"; f "' ake a liable to bold the result w'l 

r eW ?ui "“ i “" * as the default 
(, e - we assume a “miss") 



© 



for (int cell : locationCells) { 
if (guess = cell) { 
result = "hit"; 



Compare tbe user au... i 



© 

numOf Hits++ ; 



w e a bit/ 



©, 



test tbe other dells 



break ; 

} // end if 
} // end for 

if (numOf Hits == locationCells . length) { 
result = "kill"; ^ 

} // end if 



ti,e '"p- w w, i« it , 

result String to Till" 



were 



System. out. println (result) ; display tbe result -for -the usev- 

return result; (“Miss", unless it was dbanged to "Hit" or Till”) 



^return tbe result badk to 
} //end method tbe tailing method 
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writing a program 



prep code test code 



Just the new stuff 

The things we haven’t seen before 
are on this page. Stop worrying! The 
rest of the details are at the end of 
the chapter. This is just enough to let 
you keep going. 



© Converting a 

String to an int 






I 



A method i n the 
Integer dlass that 
knows how to "parse” 

a string into the int 
it represents. 









I 



/ 






+iha 



Integer.parselnt (“3”) 



Read tW.s tor loo? debate* » ■'peat 
U eath element mtte 
away- take the e the array 

and ass'.y> it to the mt^r.able dell • 

© The for Ioo p for (int cell : locationCells) { } 



Ttle Co/o h (■) 

w hole J.L- /. 

'L 



/ 

1“'*'* ^ Wd‘ one element 

^ he L fyy ^h time through the loop, 

M Cell"T' Ul h M ih jcT e Vairiable " 3n ' ed 

array unt,| there are no more elements (or the 
Code does a 'break"... see # 4 - below). 






in the M' 
the 



The ay 3 ] the ,WJ| JJyeA to 



endo^th- 



@ The post- increment 
operator 



numOfHits++ 



The ++ means add I to 
whatever^ there (in other 
words, indrement by I). 



numO'Pttits++ is the same (in 
this dase) as saying numC-fttits — 
num C-fttits + I, e*dept slightly 
more e-f-fidient- 



( 4 ) break statement 



break; 



£jets you out o-f a loop. Immediately. Right here- 
No iteration, no boolean test, \ust <\et put now / 
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SimpleDotCom class 




Integer.parselntO if the thing you 
pass isn't a number? And does it 
recognize spelled-out numbers, 
like "three"? 

A- 

Jr \‘ Integer.parselntO works only 
on Strings that represent the ascii 
values for digits (0,1, 23,4,5,6,7,8,9). 
If you try to parse something like 
"two"or"blurp"the code will blow 
up at runtime. (By blow up, we 
actually mean throw an exception, 
but we don't talk about exceptions 
until the Exceptions chapter. So for 
now, blow up is close enough.) 



Q/ In the beginning of the 
book, there was an example of a 
for loop that was really different 
from this one — are there two 
different styles of for loops? 



Yes! From the first version of 
Java there has been a single kind 
of for loop (explained later in this 
chapter) that looks like this: 

for (int i = 0; i < 10; i++) { 

// do something 1 0 times 

} 

You can use this format for any 
kind of loop you need. But... 
beginning with Java 5.0 (Tiger), 
you can also use the enhanced for 
loop (that's the official description) 
when your loop needs to iterate 
over the elements in an array (or 
another kind of collection, as you'll 
see in the next chapter). You can 
always use the plain old for loop 
to iterate over an array, but the 
enhanced for loop makes it easier. 
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Final code for SiitiplePofCow and SiwplePotCowTester 

public class SimpleDotComTestDrive { 

public static void main (String [] args) { 
SimpleDotCom dot = new SimpleDotCom () ; 
int[] locations = {2,3,4}; 
dot . setLocationCells (locations) ; 

String userGuess = "2"; 

String result = dot . checkYourself (userGuess ) ; 



public class SimpleDotCom { 

int [ ] locationCells; 
int numOfHits = 0; 

public void setLocationCells (int [ ] Iocs) { 
locationCells = Iocs; 

} 



public String checkYourself (String stringGuess) 
int guess = Integer .parselnt (stringGuess) ; 
String result = "miss"; 
for (int cell : locationCells) { 
if (guess == cell) { 
result = "hit"; 
numOfHits++; 
break; 



// 



} // out of the loop 

if (numOfHits == 

locationCells . length) ■ 
result = "kill"; 

} 

System. out .print In (result) , 
return result; 

► / / close method 
close class 



What should we see 
when we run this code? 

The test code makes a 
SimpleDotCom object 
and gives it a location at 
2,3,4. Then it sends a fake 
user guess of "2" into the 
checkYouselfO method. 

If the code is working 
correctly, we should see the 
result print out: 



There’s a little bug lurking here. It compiles and 
runs, but sometimes... don’t worry about it for now, 
but we will have to face it a little later. 



java SimpleDotComTestDrive 
hit 
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writing a program 



prep code 



test code 



real code 



Sharpen your pencil 



We built the test class, and the SimpleDotCom class. But we still haven't 
made the actual game. Given the code on the opposite page, and the spec for 
the actual game, write in your ideas for prepcode for the game class. We've given 
you a few lines here and there to get you started. The actual game code is on the 
next page, so don't turn the page until you do this exercise! 



You should have somewhere between 1 2 and 1 8 lines (including the ones we wrote, 
but not including lines that have only a curly brace). 



METHOD public static void main (String [] args) 

DECLARE an int variable to hold the number of user guesses, named numOfGuesses 



The SimpleDotComGame 
needs to do this: 

1 . Make the single 
SimpleDotCom Object. 

2. Make a location for it (three 
consecutive cells on a single 
row of seven virtual cells). 

3. Ask the user for a guess. 

4. Check the guess. 

5. Repeat until the dot com is 
dead . 



6. Tell the user how many 
guesses it took. 



COMPUTE a random number between 0 and 4 that will be the starting location cell position 



WHILE the dot com is still alive : 

GET user input from the command line 



A complete game interaction 

[ File Edit Window Help Runaway 



%java SimpleDotComGame 
enter a number 2 
hit 

enter a number 3 
hit 

enter a number 4 
miss 

enter a number 1 
kill 

You took 4 guesses 
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SimpleDotCom class 



jrep code 



test code 



real code 



Prepcode for the SiiwplePotCowdawe class 

Everything happens in mainO 

There are some things you’ll have to take on faith. For example, we have one 
line of prepcode that says, “GET user input from command-line”. Let me tell 
you, that’s a little more than we want to implement from scratch right now. But 
happily, we’re using OO. And that means you get to ask some other class/ object 
to do something for you, without worrying about how it does it. When you write 
prepcode, you should assume that somehow you’ll be able to do whatever you 
need to do, so you can put all your brainpower into working out the logic. 



public static void main (String [] args) 

DECLARE an int variable to hold the number of user guesses, named numOfGuesses, set it to 0. 
MAKE a new SimpleDotCom instance 

COMPUTE a random number between 0 and 4 that will be the starting location cell position 

MAKE an int array with 3 ints using the randomly-generated number, that number incremented by I , 
and that number incremented by 2 (example: 3,4,5) 

INVOKE the setLocationCellsQ method on the SimpleDotCom instance 

DECLARE a boolean variable representing the state of the game, named isAlive. SET it to true 



WHILE the dot com is still alive (isAlive == true) : 

GET user input from the command line 
// CHECK the user guess 

INVOKE the checkYourselfQ method on the SimpleDotCom instance 
INCREMENT numOfGuesses variable 
// CHECK for dot com death 
IF result is “kill” 



SET isAlive to false (which means we won’t enter the loop again) 
PRINT the number of user guesses 



END IF 
END WHILE 
END METHOD 




metacog nifrVe 



Don’t work one part of the brain for too long a stretch at one time. 
Working just the left side of the brain for more than 30 minutes 
is like working just your left arm for 30 minutes. Give each side 
of your brain a break by switching sides at regular intervals. 

When you shift to one side, the other side gets to rest and 
recover. Left-brain activities include things like step-by-step 
sequences, logical problem-solving, and analysis, while the 
right-brain kicks in for metaphors, creative problem-solving, 
pattern-matching, and visualizing. 
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writing a program 



Your Java program should start with a high- 
level design. 

Typically you’ll write three things when you 
create a new class: 

prepcode 
testcode 
real (Java) code 

Prepcode should describe what to do, not how 
to do it. Implementation comes later. 

Use the prepcode to help design the test 
code. 

Write test code before you implement the 
methods. 



■ Choose for loops over while loops when you 
know how many times you want to repeat the 
loop code. 

■ Use the pre/post increment operator to add 1 
to a variable (x++;) 

■ Use the pre/post decrement to subtract 1 from 
a variable (x-;) 

■ Use Integer .parselnt() to get the int 
value of a String. 

■ Integer .parselnto works Only if the 
String represents a digit (“0”,”T’,”2”, etc.) 

■ Use break to leave a loop early (i.e. even if 
the boolean test condition is still true). 
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SimpleDotComGame class 



prep code test code 



The game's waiwO method 



Just as you did with the SimpleDotCom class, be thinking about parts of this code 
you might want (or need) to improve. The numbered things ( 7 ) are for stuff we 
want to point out. They’re explained on the opposite page. Oh, if you’re wonder- 
ing why we skipped the test code phase for this class, we don’t need a test class for 
the game. It has only one method, so what would you do in your test code? Make 
a separate class that would call main() on this class? We didn’t bother. 



DECLARE a vari 
able to hold user 
guess count, set it 
to 0 



public static void main (String [] args) { 
int numOfGuesses = 0 ; ^ 



m ake a variable w ,w, s 

3 * tbe usev 

many jesses the 



GameHelper helper = new GameHelper ( ) ; 



“this is 3 spedial dlass we v/v-otd that has 
the method (or ge-ttmg user input- (or 
now, pretend it's part o( Java 



MAKE a SimpleDot- 
Com object 

COMPUTE a 

random number 
between 0 and 4 

MAKE an int array 
with the 3 cell loca- 
tions, and 

INVOKE setLoca 
tionCells on the dot 
com object 

DECLARE a bool 
ean isAlive 

WHILE the dot 
com is still alive 

GET user input 



SimpleDotCom theDotCom = new SimpleDotCom () ; ^ ^ make the dot dom obiedt 

© ^ j, 

int randomNum = (int) (Math . random ( ) * 5) ; ' " ^3ke a random number -for fL* £ ^ 1 

— lodaifioKs array 

int[] locations = {randomNum, randomNum+1, randomNum+2 } ; 



theDotCom. setLocationCells (locations) ; 
boolean isAlive = true; 



„ ve the dot tom •its Stations array) 



yve 



make a boolean variable to tradk whether the game 
is still alive, to use in the while loop test- repeat 
'* while game is still alive- 

© get SbrW% 

String guess = helper . getUser Input ("enter a number") 



while (isAlive == true) { 



// CHECK it 

INVOKE checkYo 
urselfO on dot com 

INCREMENT 

numOfGuesses 

IF result is “kill" 

SET game Alive to 
false 

PRINT the number 
of user guesses 



String result = theDotCom. checkYourself (guess) ; ask the dot 



numOf Guesses++ ; 



indrement guess dount 



the 

m a Si,, i e ' reU, * d 



if (result. equals ("kill") ) ^ 

isAlive = false; ^ 



•ng 



was it a “kill"? if so, set isAlive to false (so *e Wt 
e enter the loop) and print user guess dount 

; 



System. out .println ("You took " + numOfGuesses + " guesses") 

} // close if 
} // close while 
// close main 
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writing a program 



prep code 



randomO and getUserlnputO 



Two things that need a bit more 
explaining, are on this page. This is 
just a quick look to keep you going; 
more details on the GameHelper 
class are at the end of this chapter. 



© 



Make a random 
number 



y* e hav e ,Uob e iJtfT 

a j 4 T+? hole M i >e * ^ o 

f d J l ih,s «se, -the casi | ops 0 rr 
* he tracheal ? ari «f ihe doubt + 



/ 



The Math-vawiom method 
returns a number trom zero to 
lust less than one. So this formula 

kith the east), returns a number 

trom 0 to ^ ('-e. 0 - T-TT?- 
east to an int) 

l 



int randomNum = 



T 

I/Ve dedlav-e an int variable to bold 
tbe random number we get badk. 



(int) (Math. randomO * 

r \ 

A dlass that domes A method o( tbe 
with Java. Math dlass. 



S) 



© 



Getting user input 
using the GameHelper 
class 



An instande we made earlier, 
cJc a dlass that we built to 
help with tbe game- Its dalled 
^amettelyer and you haven t 
seen it yet (you will). 



.y^di^r » ^e 3 e t 

bet or e the 



String guess = helper. getUserlnput (“enter a number”); 



t 

JVe declare a String variabl< 

ho d the user input Strina y, 
9«t back ("Z‘\ V e ^. ) 9 



T 

A method the ^amettelfer dlass 
that asks the user -for dommand- 
line infut, reads it in a-fter the 
user hits RETURN, and gives badk 
the result as a String. 
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GameHelper class (Ready-bake) 



prep code 



One last class; GameHelper 

We made the dot com class. 

We made the game class. 

All that’s left is the helper class — the one with the 
getUserInput() method. The code to get command- 
line input is more than we want to explain right now. 
It opens up way too many topics best left for later. 
(Later, as in chapter 14.) 




Just copy* the code below and compile it into 
a class named GameHelper. Drop all three 
classes (SimpleDotCom, SimpleDotComGame, 
GameHelper) into the same directory, and make it 
your working directory. 

Mj^ Readf-hake 

Whenever you see the logo, you’re see- 

ing code that you have to type as-is and take on faith. 
Trust it. You’ll learn how that code works later. 



Reatty'kake 

Odds 



import j ava . io . * ; 
public class GameHelper { 

public String getUser Input (String prompt) { 
String inputLine = null; 

System . out . print (prompt + " " ) ; 

try { 

Buf feredReader is = new Buf feredReader ( 
new InputStreamReader (System. in) ) ; 
inputLine = is . readLine ( ) ; 

if (inputLine . length () == 0 ) return null; 
} catch (IOException e) { 

Sy s tern . out . pr intln ( " IOException : " + e ) ; 

} 

return inputLine; 



*We know how much you enjoy typing, but for those rare 
moments when you’d rather do something else, we’ve made 
the Ready-bake Code available on wickedlysmart.com. 
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writing a program 



let's play 

Here's what happens when we 
run it and enter the numbers 
1,2,3 ,4,5,6. Lookin' good. 



What's this? A bug ? 

Gasp! 

Here's what happens when we 
enter 1,1,1. 



A complete game interaction 

(your mileage may vary) 
rFiie~EdirTvindow"*HeTp*^miie^^^^~^^^^~ 



%java SimpleDotComGame 
enter a number 1 
miss 

enter a number 2 
miss 

enter a number 3 
miss 

enter a number 4 
hit 

enter a number 5 
hit 

enter a number 6 
kill 

You took 6 guesses 



A different game interaction 

(yikes) 

File Edit Window Help Faint 



%java SimpleDotComGame 
enter a number 1 
hit 

enter a number 1 
hit 

enter a number 1 
kill 

You took 3 guesses 




- Sharpen your pencil 

It's a cliff-hanger! 

Will we find the bug? 

Will we fix the bug? 



Stay tuned for the next chapter, where we answer 
these questions and more... 

And in the meantime, see if you can come up with 
ideas for what went wrong and how to fix it. 
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for loops 



More about for loops 

We’ve covered all the game code for this chapter (but we’ll pick it up again 
to finish the deluxe version of the game in the next chapter). We didn’t 
want to interrupt your work with some of the details and background info, 
so we put it back here. We’ll start with the details of for loops, and if you’re 
a C++ programmer, you can just skim these last few pages... 



Regular (won-enhanced) for loops 



yost-indremetti oycv-atov 



the 



to d c i 0 



for(int i = 0; i < 100; i++) 






... / 



T 

boolean -tes-t 



t 

iteration expression 



What it means in plain English: "Repeat 1 00 times." 
How the compiler sees it: 

* create a variable / and set it to 0. 



* repeat while / is less than 1 00. 

* at the end of each loop iteration, add 1 to / 



Part One: initialization 

Use this part to declare and initialize a variable to use within the loop body. 
You'll most often use this variable as a counter. You can actually initialize more 
than one variable here, but we'll get to that later in the book. 

Part Two: boolean test 

This is where the conditional test goes. Whatever's in there, it must resolve to a 
boolean value (you know, true or false). You can have a test, like (x >= 4), or you 
can even invoke a method that returns a boolean. 

Part Three: iteration expression 

In this part, put one or more things you want to happen with each trip through 
the loop. Keep in mind that this stuff happens at the end of each loop. 



repeat for 1 00 reps: 
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writing a program 



Trips through a loop 

for (int i = 0; i < 8; i++) { 

System. out .pr in tin (i) ; 

} 

System. out .pr in tin ("done") ; 




Pifferewce between for and while 

A while loop has only the boolean test; it doesn't have 
a built-in initialization or iteration expression. A while 
loop is good when you don't know how many times to 
loop and just want to keep going while some condi- 
tion is true. But if you know how many times to loop 
(e.g. the length of an array, 7 times, etc.), a for loop is 
cleaner. Here's the loop above rewritten using while: 



. We ,^-tod«U e ^ 



int i = 0; 

while (i < 8) { 

System. out .pr in tin (i) ; 
i++ ; 

} 

System. out .pr in tin ("done") ; 



Wc ■ 



output: 

rTiTe"*EdiMA/indov7*He^ 



%java Test 
0 
1 
2 

3 

4 

5 

6 
7 

done 



++ 

Pre and Post Increment/Decrement Operator 

The shortcut for adding or subtracting 1 from a variable. 

x++; 

is the same as: 

x = x + 1; 

They both mean the same thing in this context: 

"add 1 to the current value of x"or "increment x by 1" 

And: 

x — ; 

is the same as: 

x = x - 1; 

Of course that's never the whole story. The placement of the 
operator (either before or after the variable) can affect the re- 
sult. Putting the operator before the variable (for example, ++x), 
means, "first, increment x by 1 , and then use this new value of x." 
This only matters when the ++x is part of some larger expres- 
sion rather than just in a single statement. 

int x = 0 ; int z = ++x ; 

produces: x is 1 , z is 1 

But putting the ++ after the x give you a different result: 
int x = 0 ; int z = x++ ; 

produces: x is 1, but z is 0\ z gets the value of x and then x is 
incremented. 
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enhanced for 



The enhanced for loop 

Beginning with Java 5.0 (Tiger), the Java language has a second kind of for loop 
called the enhanced for, that makes it easier to iterate over all the elements in an 
array or other kinds of collections (you’ll learn about other collections in the next 
chapter) . That’s really all that the enhanced for gives you — a simpler way to walk 
through all the elements in the collection, but since it’s the most common use of a 
for loop, it was worth adding it to the language. We’ll revisit the enhanced for loop in 
the next chapter, when we talk about collections that aren’t arrays. 



Dedlave an i-bevaiion variable Th e £ 0 / 0h ^ 
-that will bold a single element m Mhs 

‘“i "the dVV’dY* ^ 



for (String name : nameArray) { 

eath iWaU 
a di-f-ferettt 
m arraY W.J 
be assumed to the 
variable 'Va^e • 



s 



Ue Co* ^ 

( Se £j£f 



.1 



S 

The elements in the 
airnay MUST be 
Compatible with the 
dedaved variable type. 



} 



r . . that volant bo iterate over. 

The eolleetion •? ie dode said: 

Imagine that somew „ ,n ill. 

, n a , Avrav =S ff«d*, Many , t> ob J ’ 

Stn,ngC3 name* 7 va * a bU has t 



What it means in plain English: "For each element in nameArray, assign the 
element to the 'name' variable, and run the body of the loop." 



How the compiler sees it: 

* Create a String variable called name and set it to null. 

* Assign the first value in nameArray to name. 

* Run the body of the loop (the code block bounded by curly braces) 

* Assign the next value in nameArray to name. 

* Repeat while there are still elements in the array. 

Part One: iteration variable declaration 

Use this part to declare and initialize a variable to use within the loop body. With each 
iteration of the loop, this variable will hold a different element from the collection. The 
type of this variable must be compatible with the elements in the array! For example, 
you can't declare an int iteration variable to use with a StringO array. 

Part Two: the actual collection 

This must be a reference to an array or other collection. Again, don't worry about the 
other non-array kinds of collections yet — you'll see them in the next chapter. 
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writing a program 



Converting a String to an int 

int guess = Integer .par selnt(s tringGuess) ; 

The user types his guess at the command- 
line, when the game prompts him. That 
guess comes in as a String ("2', "'O',' etc.) , 
and the game passes that String into the 
checkYourselfO method. 

But the cell locations are simply ints in an 
array, and you can't compare an int to a 
String. 

For example, this won't work: 

String num ="2"; 
int x = 2; 

if(x==num) // horrible explosion! 

Trying to compile that makes the compiler 
laugh and mock you: 



operator == cannot be applied to 
int , j ava . lang . String 

if (x == num) { } 



So to get around the whole apples and 
oranges thing, we have to make the String 
"2" into the int 2. Built into the Java class 
library is a class called Integer (that's right, 
an Integer class, not the int primitive ), 
and one of its jobs is to take Strings that 
represent numbers and convert them into 
actual numbers. 



i 

Integer.parseIntC“3”) 



tikes 3 S-tv-i h Q 

l 



/ 

3 method ih "the 

^Idss ‘thd't khows how £o 
Vsc” a £tH* 9 ih-fco £hc 

it represents. 




Casting 

primitives 




long 



► short 

can be cast to 




but you might 
lose something 




leU 

*** M off 



In chapter 3 we talked about the sizes of the various primitives, and how you 
can’t shove a big thing directly into a small thing: 

long y = 42; 

int x = y; // won't compile 

A long is bigger than an int and the compiler can’t be sure where that long has 
been. It might have been out drinking with the other longs, and taking on really 
big values. To force the compiler to jam the value of a bigger primitive variable 
into a smaller one, you can use the cast operator. It looks like this: 

long y = 42; // so far so good 

int x = (int) y; // x = 42 cool! 

Putting in the cdst tells the compiler to take the value of y, chop it down to int 
size, and set x equal to whatever is left. If the value of y was bigger than the 
maximum value of x, then what’s left will be a weird (but calculable*) number: 

long y = 40002; 

// 40002 exceeds the 16 -bit limit of a short 



short x = (short) y; // x now equals -25534! 

Still, the point is that the compiler lets you do it. And let’s say you have a float- 
ing point number, and you just want to get at the whole number (int) part of it: 



float f = 3.14f; 

int x = (int) f; // x will equal 3 

And don’t even think about casting anything to a boolean or vice versa— just 
walk away. 

*lt involves sign bits, binary, ‘two’s complement’ and other geekery, all of which 
are discussed at the beginning of appendix B. 
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exercise: Be the JVM 




BE die JVM 



The Java file on this page 
represents a complete source 
file. Your job is to play JVM 
and determine what would be 
the output when the 
program runs? 




class Output { 



File Edit Window Help OM 



% java Output 
12 14 



public static void main (String [] args ) { 
Output o = new Output ( ) ; 



o.go( ) ; 

} 

void go( ) { 
int y = 7 ; 

for(int x = 1; x < 8; x++) { 

y++; 

if (x > 4) { 

System. out .print (++y + " " ) ; 

} 

if (y > 14) { 

System. out .println( " x = " + x); 
break; 

} 

} 



- or - 



File Edit Window Help Incense 



% java Output 
12 14 x = 6 



-or- 



File Edit Window Help Believe 



% java Output 
13 15 x = 6 



} 



} 
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writing a program 





Code Magnets 

A working Java program is all scrambled up on the fridge. Can you 
reconstruct the code snippets to make a working Java program that 
produces the output listed below? Some of the curly braces fell on the 
floor and they were too small to pick up, so feel free to add as many of 
those as you need! 




0 3 

1 4 
1 3 
3 4 
3 3 



you are here ► 119 



Head First Java, 2nd Edition. Head First Java, 2nd Edition, ISBN: 0596009208 

Prepared for e.simons@icarin.fiuc.org, Eduard Simons 

Copyright © 2005 Bert Bates and Kathy Sierra. This PDF is made available for personal use only during the relevant subscription term, subject to the Safari Terms of Service. Any other use 
requires prior written consent from the copyright owner. Unauthorized use, reproduction and/or distribution are strictly prohibited and violate applicable laws. All rights reserved. 




puzzle: JavaCross 





1 




2 


















3 












4 


5 










6 




























7 










8 




9 




10 
















11 








12 














































13 


















14 








15 








16 






































17 
















18 








19 












































20 




21 
















































22 




















23 






24 




















25 














26 








27 
































28 






















29 

























How does a crossword puzzle 
help you learn Java? Well, all 
of the words are Java related. 
In addition, the clues provide 
metaphors, puns, and the like. 
These mental twists and turns 
burn alternate routes to Java 
knowledge, right into your 
brain! 



Across 

I. Fancy computer word 
for build 

4. Multi-part loop 

6. Test first 

7. 32 bits 

10. Method's answer 

I I . Prepcode-esque 
13. Change 

15. The big toolkit 

17. An array unit 

18. Instance or local 



20. Automatic toolkit 

22. Looks like a primitive, 
but.. 

25. Un-castable 

26. Math method 

28. Converter method 

29. Leave early 



Down 

2. Increment type 21 . As if 

3. Class's workhorse 23. Add after 

5. Pre is a type of 24. Pi house 

6. For's iteration 26. Compile it and 

7. Establish first value 27. ++ quantity 

8. While or For 

9. Update an instance variable 
12. Towards blastoff 

14. A cycle 

16. Talkative package 

19. Method messenger 
(abbrev.) 
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writing a program 




Messages 



A short Java program is listed below. One block of the program 
is missing. Your challenge is to match the candidate block of 
code (on the left), with the output that you'd see if the block 
were inserted. Not all the lines of output will be used, and some 
of the lines of output might be used more than once. Draw lines 
connecting the candidate blocks of code with their matching 
command-line output. 



class MixFor5 { 

public static void main (String [ 
int x = 0 ; 
int y = 30; 

for (int outer = 0; outer < 3; 
for (int inner = 4; inner > 1 



args) { 



outer++) 
inner-- ) 



{ 



} 



y = y - 2; 
if (x == 6) { 

break; 

} 

x = x + 3 ; 

} 

y = y - 2; 

} 

System . out . println (x + " " + 



9 °« here 



todc 



y) ; 



Candidates: 




Possible output: 



45 6 



36 6 



54 6 



60 10 



18 6 



6 14 



12 14 
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exercise solutions 






Exercise Solutions 



Be the JVM: 

class Output { 

public static void main (String [] args ) { 
Output o = new Output ( ) ; 
o . go ( ) ; 

} 

void go ( ) { 
int y = 7 ; 

for(int x = 1; x < 8; x++) { 

y++; 

if (x > 4) { 

System. out .print (++y + " "); 

} 

if (y > 14) { 

System. out. println ( " x = " + x); 
break; 

} 

} 



} Did you remember to factor in the 

break statement? How did that 
affect the output? 



% java Output 
13 15 x = 6 



Code Magnets: 

class MultiFor { 

public static void main (String [] args) { 

for (int x = 0; x < 4; x++) { 

for (int y = 4; y > 2; y--) { 

System. out. println (x + " " + y); 

} 



if (x == 1) { 
x++; 

} 

} 

} 

I File Edit Window Help Monopole 



% java MultiFor 
0 4 

0 3 

1 4 
1 3 
3 4 
3 3 



What would happen 
if this code block came 
before the y' for loop? 
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writing a program 




puzz]e Solutions 




Candidates: Possible output: 
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6 get to know the Java API 



Using the Java Library 




Java ships with hundreds of pre-built classes. You don't have to 

reinvent the wheel if you know how to find what you need in the Java library, known as 
the Java API. You've got better things to do. If you're going to write code, you might as well 
write only the parts that are truly custom for your application. You know those programmers 
who walk out the door each night at 5 PM? The ones who don't even show up until 10 AM? 
They use the Java API. And about eight pages from now, so will you. The core Java library 
is a giant pile of classes just waiting for you to use like building blocks, to assemble your own 
program out of largely pre-built code. The Ready-bake Java we use in this book is code you 
don't have to create from scratch, but you still have to type it. The Java API is full of code you 
don't even have to type. All you need to do is learn to use it. 



this is a new chapter 1 25 



Head First Java, 2nd Edition. Head First Java, 2nd Edition, ISBN: 0596009208 

Prepared for e.simons@icarin.fiuc.org, Eduard Simons 

Copyright © 2005 Bert Bates and Kathy Sierra. This PDF is made available for personal use only during the relevant subscription term, subject to the Safari Terms of Service. Any other use 
requires prior written consent from the copyright owner. Unauthorized use, reproduction and/or distribution are strictly prohibited and violate applicable laws. All rights reserved. 





we still have a bug 



In our last chapter, we left you 
with the cliff-hanger A bug. 



How it's supposed to look How the bug looks 



Here's what happens when we 
run it and enter the numbers 
1,2, 3, 4, 5, 6. Lookin' good. 

A complete game interaction 

(your mileage may vary) 



%java SimpleDotComGame 
enter a number 1 
miss 

enter a number 2 
miss 

enter a number 3 
miss 

enter a number 4 
hit 

enter a number 5 
hit 

enter a number 6 
kill 

You took 6 guesses 



Here's what happens when we 
enter 2,2,2. 



A different game interaction 

(yikes) 



| File Edit Window Help Faint 


1 


%java SimpleDotComGame 


enter a number 
hit 


2 


enter a number 
hit 


2 


enter a number 
kill 


2 


You took 3 guesses 



In the current version, once 
you get a hit, you can simply 
repeat that hit two more 
times for the kill! 
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So what happened? 



get to know the Java API 



public String checkYour self (String stringGuess) { 



int guess = Integer .par selnt (stringGuess) ; ^ ^ Cohvcv- t -the S-fo-iha 

to iht 



String result = "miss" 



<- 



. Make a variable to hold the result 

^WRutW'i rasthede^t 

(, e - we assume a "miss"). 



we I 



for (int cell : locationCells) { 



Here’s where it 
goes wrong. We 
counted a hit every « — ^ 
time the user 
guessed a cell 
location, even if 
that location had 
already been hit! 



if (guess == cell) { 
result = "hit" ; 

9 °t a hit/ 

numOf Hits++ ; 



break ; 



} // end if 



4«t outof the | oop ,, 0 

the other ills. 



Compare the user 
9 uess to this element 
Ciell), in the array. 



We need a way to 
know that when 
a user makes 
a hit, he hasn’t 
previously hit that 
cell. If he has, then 
we don’t want to 
count it as a hit. 



} // end for 



if (numOfHits == locationCells . length) 
result = "kill"; 

} // end if 



{ *^M*"*°t the loop, but 
lets see i-f weVe how 'dead' 
l times) ahd dhange the 
r«ult String to w ki|| w 



System, out. prin tin (result) ; ^ — Display tKe result -for the usev- 

(Viss” Uhless it was ehahged to “hit” or V.ID. 
return result; J 

Return the result back to 

// end method the falling method. 



you are here ► 127 



Head First Java, 2nd Edition. Head First Java, 2nd Edition, ISBN: 0596009208 

Prepared for e.simons@icarin.fiuc.org, Eduard Simons 

Copyright © 2005 Bert Bates and Kathy Sierra. This PDF is made available for personal use only during the relevant subscription term, subject to the Safari Terms of Service. Any other use 
requires prior written consent from the copyright owner. Unauthorized use, reproduction and/or distribution are strictly prohibited and violate applicable laws. All rights reserved. 




fixing the bug 



How do we fix it? 



We need a way to know whether a cell has already been hit. Let's run 
through some possibilities, but first, we'll look at what we know so far... 

We have a virtual row of 7 cells, and a DotCom will occupy three 
consecutive cells somewhere in that row. This virtual row shows a 
DotCom placed at cell locations 4,5 and 6. 



0 12 3 







The DotCom has an instance variable— an int array— that holds that 
DotCom object's cell locations. 



locationCells 

(instance variable of 
the DotCom) 




ihe ^ needs -to 3ue ' ihe •"■"■tew 



0 Option owe 

We could make a second array, and each time the user makes a hit, we 
store that hit in the second array, and then check that array each time 
we get a hit, to see if that cell has been hit before. 



false 



hitCells array 

(this would be a 
new boolean array 
instance variable of 
the DotCom) 







‘■ell ai index 2 is if II e * 3rn f e ’ ^ 

iht UC e"s" arfy\f^f '* d ' 
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get to know the Java API 



Option one is too clunky 

Option one seems like more work than you'd expect. It means that each 
time the user makes a hit, you have to change the state of the second 
array (the ’hitCells' array), oh — but first you have to CHECK the 'hitCells' 
array to see if that cell has already been hit anyway. It would work, but 
there's got to be something better... 



d) Option two 

We could just keep the one original array, but change the value of any hit 
cells to -1. That way, we only have ONE array to check and manipulate 



locationCells 

(instance variable of 
the DotCom) 



fifth 



f h * V ihe td 

- 1 **3 ai.ve numbers i„ £ he array. V °° km9 no »- 



Option two is a little better, but 
still pretty clunky 

Option two is a little less clunky than option one, but it's not very efficient. You'd 
still have to loop through all three slots (index positions) in the array, even if 
one or more are already invalid because they've been 'hit' (and have a -1 value). 
There has to be something better... 
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prep code 

prep code test code 



real code 



® Option three 

We delete each cell location as it gets hit, and then modify the array to 
be smaller. Except arrays can't change their size, so we have to make a 
new array and copy the remaining cells from the old array into the new 



smaller array. 



locationCells array 

BEFORE any cells 
have been hit 



h .to ; 



locationCells array 

AFTER cell '5', which 
was at index 1 in the 
array, has been hit 




array siaris ou£ wi-fck a siz* 

, a»d we loop ihvouqh all l ,.|i< 
(positions in ike arrav) 2 i i r s 

a -akh to lo ° k 

the tell value ly** 9ue “ 3nd 

Whe* tell IS L;i , 

smaller array wN f xf ke 3 ne ' N> 

inn tell the ***»- 

loiaiionCells rtfe" ^ 



assign 
fcrcnCc. 



Option three would be much better if the array could shrink, so that we wouldn't have 
to wake a new smaller array, copy the remaining values in, and reassign the reference. 



The original prepcode for part of the 
checkYourselfO method: 

REPEAT with each of the location cells in the int array 
// COMPARE the user guess to the location cell 
IF the user guess matches 

INCREMENT the number of hits 
// FIND OUT if it was the last location cell: 

IF number of hits is 3 , RETURN “kill” 

ELSE it was not a kill, so RETURN“hit'' 

END IF 

ELSE user guess did not match, so RETURN “miss” 
END IF 
END REPEAT 



Life would be good if only we could 
change it to: 

REPEAT with each of the remaining location cells 
// COMPARE the user guess to the location cell 
IF the user guess matches 

REMOVE this cell from the array 
// FIND OUT if it was the last location cell: 

IF the array is now empty, RETURN “kill” 
ELSE it was not a kill, so RETURN“hit” 

END IF 

ELSE user guess did not match, so RETURN “miss” 
END IF 
END REPEAT 



► 

* 
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get to know the Java API 




If only I could find an array 
that could shrink when you remove 
something. And one that you didn't have 
to loop through to check each element, but 
instead you could just ask it if it contains 
what you're looking for. And it would let you 
get things out of it, without having to know 
exactly which slot the things are in. 

That would be dreamy. But I know it's 
just a fantasy... 
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when arrays aren’t enough 



Wake up and smell the library 



As if by magic, there really is such a thing. 

But it’s not an array, it’s an ArrayList . 

A class in the core Java library (the API). 

The Java Standard Edition (which is what you have unless you’re work- 
ing on the Micro Edition for small devices and believe me, you’d know) 
ships with hundreds of pre-built classes. Just like our Ready-Bake code 
except that these built-in classes are already compiled. 



That means no typing. 
Just use ‘em. 



ArrayList 



One of a gazillion classes m 
the Java library. 

You ta» use it in your Code 
as i-f you wrote it yoursel-f. 









index para (T ' eter ‘ 



(Note; the add(0bjeet clem) method 
actually looks a little stranger than the 
one we’ve shown here-., we’ll $et to the 
real one later in the book. For now, just 
think of it as an addO method that 
takes the object you want to add ) 






Returns 



or d 



isE^ptVO the ,i S t has no elements 

Returns true 

, a 0 „ P it of SOMt of 
Ttosisjieta sa»? 

the methods » 
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get to know the Java API 



Sowe things you can do with Arraylist 

(T) Make one v\^t *o*> wcan ';J| 

ArrayList<Eqg> myList = new ArrayList<Egg> ( ) ; k ^1 \st oV\c^t ^ 



( 5 ) Put something in it 

Egg s = new Egg ( ) ; 

myList . add (s) ; 

(3) Put another thing in it 

Egg b = new Egg ( ) ; 

myList . add (b) ; 



feJ 






Nov.^A^ayUstr^sa'W” 

■to Viold the 



" " 



(4) Find out how many things are in it 

int theSize = myList . size () ; 

(5) Find out if it contains something 

boolean isln = myList . contains (s) 



■ The '.s V>oldm 5 2. objeeis : 

+V>e S,ze 0 "^hod «U** £. 



The AvvaYL-ist P0£S dor,tamthe£<$ 

. ve£evended b 7 's', so do^msO reW 



i i * _ j (mejns £ivst mde* *s 0) 

( 6 ) Find out where something is (i.e. its index) ,s z ^ r0 '\ p , , y was the 

// and sinte the objedt ve+evencea 7 1 

^ sedond thin 5 in the list, \»dt*OW neWns^ 



int idx = myList . indexOf (b) ; 



® Find out if ifs empty V. drfwt* m ^ ^ . j6> 

boolean empty = myList . isEmpty () ; t — * ^ctmrus T^js g 

(§) Remove something from it ^ey ^ s ^ a ^- 

myLi s t . remove ( s ) ; f 
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when arrays aren’t enough 




Fill in the rest of the table below by looking at the ArrayList code 
on the left and putting in what you think the code might be if it 
were using a regular array instead. We don't expect you to get all 
of them exactly right, so just make your best guess. 



ArrayList regular array 



ArrayList<String> myList = new 
ArrayList<String> () ; 


String CJ myList — new StringCZJ; 






String a = new String ("whoohoo" ) ; 


String a — new StringC'wbooboo”); 


myList . add (a) ; 








String b = new String ("Frog") ; 


String b — new StringO'Frog^); 


myList . add (b) ; 








int theSize = myList . size () ; 








Object 0 = myList . get (1) ; 








myList . remove ( 1 ) ; 








boolean isln = myList . contains (b) ; 
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get to know the Java API 



^tliereiarerio 

Dumb Questions 

Q/So ArrayList is cool, but 
how would I know it exists? 

./\jThe question is really, 

"How do I know what's in the 
API?" and that's the key to your 
success as a Java programmer. 
Not to mention your key to 
being as lazy as possible while 
still managing to build software. 
You might be amazed at how 
much time you can save when 
somebody else has already done 
most of the heavy lifting, and 
all you have to do is step in and 
create the fun part. 

But we digress... the short 
answer is that you spend some 
time learning what's in the core 
API. The long answer is at the 
end of this chapter, where you'll 
learn how to do that. 



0/ But that's a pretty big 
issue. Not only do I need to 
know that the Java library 
comes with ArrayList, but more 
importantly I have to know 
that ArrayList is the thing that 
can do what I want! So how 
do I go from a need-to-do- 
something to a-way-to-do-it 
using the API? 



A* 

Now you're really at the 
heart of it. By the time you've 
finished this book, you'll have 
a good grasp of the language, 
and the rest of your learning 
curve really is about knowing 
how to get from a problem to 
a solution, with you writing the 
least amount of code. If you can 
be patient for a few more pages, 
we start talking about it at the 
end of this chapter. 




Java Txiposed 

This week’s interview: 
ArrayList, on arrays 



Head First: So, Array Lists are like arrays, right? 

ArrayList: In their dreams! / am an object thank you very much. 

HeadFirst: If I’m not mistaken, arrays are objects too. They live on the heap right 
there with all the other objects. 

ArrayList: Sure arrays go on the heap, duh , but an array is still a wanna-be 
ArrayList. A poser. Objects have state and behavior, right? We’re clear on that. But 
have you actually tried calling a method on an array? 

HeadFirst: Now that you mention it, can’t say I have. But what method would I 
call, anyway? I only care about calling methods on the stuff I put in the array, not 
the array itself. And I can use array syntax when I want to put things in and take 
things out of the array. 

ArrayList: Is that so? You mean to tell me you actually removed something from an 
array? (Sheesh, where do they train you guys? Mcjava’s?) 

HeadFirst: Of course I take something out of the array. I say Dog d = dogArrayfl] 
and I get the Dog object at index 1 out of the array. 

ArrayList: Allright, I’ll try to speak slowly so you can follow along. You were not, 

I repeat not, removing that Dog from the array. All you did was make a copy of the 
reference to the Dog and assign it to another Dog variable. 

HeadFirst: Oh, I see what you’re saying. No I didn’t actually remove the Dog 
object from the array. It’s still there. But I can just set its reference to null, I guess. 

ArrayList: But I’m a first-class object, so I have methods and I can actually, you 
know, do things like remove the Dog’s reference from myself, not just set it to null. 
And I can change my size, dynamically (look it up). Just try to get an array to do that! 

HeadFirst: Gee, hate to bring this up, but the rumor is that you’re nothing more 
than a glorified but less-efficient array. That in fact you’re just a wrapper for an 
array, adding extra methods for things like resizing that I would have had to write 
myself. And while we’re at it, you can’t even hold primitives! Isn’t that a big limitation? 

ArrayList: I can’t believe you buy into that urban legend. No, I am not just a less- 
efficient array. I will admit that there are a few extremely rare situations where an 
array might be just a tad, I repeat, tad bit faster for certain things. But is it worth the 
miniscule performance gain to give up all this power. Still, look at all this flexibility. And 
as for the primitives, of course you can put a primtive in an ArrayList, as long as it’s 
wrapped in a primitive wrapper class (you’ll see a lot more on that in chapter 10). 
And as of Java 5.0, that wrapping (and unwrapping when you take the primitive out 
again) happens automatically. And allright, I’ll acknowledge that yes, if you’re using an 
ArrayList of primitives , it probably is faster with an array, because of all the wrapping 
and unwrapping, but still... who really uses primitives these days? 

Oh, look at the time! I’m late for Dilates. We’ll have to do this again sometime. 
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difference between ArrayList and array 



Comparing Arraylist to a regular array 



ArrayList regular array 




Notice how with ArrayList, you’re working 
with an object of type ArrayList, so you’re just 
invoking regular old methods on a regular old 
object, using the regular old dot operator. 



With an array, you use special array syntax (like 
myList[ 0 ] = foo) that you won’t use anywhere 
else except with arrays. Even though an 
array is an object, it lives in its own special 
world and you can’t invoke any methods on 
it, although you can access its one and only 
instance variable, length. 
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Comparing Arraylist to a regular array 



get to know the Java API 



0 A plain old array has to know its 
size at the time it’s created. 

But for ArrayList, you just make an object of 
type ArrayList. Every time. It never needs to 
know how big it should be, because it grows 
and shrinks as objects are added or removed. 

new String[2] a siz*. 

new ArrayList<String> ( ) 

Ho siz£ v-eguiv-ed (although you dan 
give it a siz£ i-f you want to). 

(g) To put an object in a regular array, 
you must assign it to a specific 
location. 

(An index from 0 to one less than the length of 
the array.) 

myList [ 1 ] = b; 

Heeds a* inde*- 

If that index is outside the boundaries of the 
array (like, the array was declared with a size of 
2, and now you’re trying to assign something 
to index 3), it blows up at runtime. 

With ArrayList, you can specify an index us- 
ing the add(anlnt, anObject) method, or you 
can just keep saying add(anObject) and the 
ArrayList will keep growing to make room for 
the new thing. 
myList . add (b) ; 

^ 0 



(3) Arrays use array syntax that’s not 
used anywhere else in Java. 

But ArrayLists are plain old Java objects, so 
they have no special syntax. 

myList [ 1 ] 

TV>e avvay bvatkAs L 3 are s ? et,a ' 
sy»ta* «ed only 



0 ArrayLists in Java 5.0 are 
parameterized. 

We just said that unlike arrays, ArrayLists 
have no special syntax. But they do use 
something special that was added to Java 5.0 
Tiger — parameterized types. 

ArrayList<String> 

The <£-tv-i*g> m a*g| c bv-adkeis is a "type 
parameter" ArrayList<£trmg> *ea*s simply "a 
list Strings , as opposed to ArrayList<Dog> 
whidh means, "a list o( Dogs". 

Prior to Java 5.0, there was no way to declare 
the type of things that would go in the 
ArrayList, so to the compiler, all ArrayLists 
were simply heterogenous collections of 
objects. But now, using the <typeGoesHere> 
syntax, we can declare and create an 
ArrayList that knows (and restricts) the 
types of objects it can hold. We’ll look at the 
details of parameterized types in ArrayLists 
in the Collections chapter, so for now, don’t 
think too much about the angle bracket <> 
syntax you see when we use ArrayLists. Just 
know that it’s a way to force the compiler to 
allow only a specific type of object ( the type in 
angle brackets) in the ArrayList. 
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the buggy DotCom code 

prep code test code 



Let's fix the PotCow code. 



Remember, this is how the buggy version looks: 



public class DotCom { 



Wev i 'T’ 0 "' tVi,s 

WleDo-tCorU to*- 1 u.i thap-bev. 



int [ ] locationCells; 
int numOfHits = 0; 



public void setLocationCells (int [ ] Iocs) { 
locationCells = Iocs; 

} 



public String checkYourself (String stringGuess) { 
int guess = Integer .parselnt (stringGuess) ; 
String result = "miss"; 



for (int cell : locationCells) { 
if (guess == cell) { 

result = "hit"; 
numOfHits++; 



k- 




break; 



} // out of the loop 

if (numOfHits == locationCells . length) { 
result = "kill"; 

} 

System. out . print In (result) ; 
return result; 

} // close method 
} // close class 
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get to know the Java API 



prep code test code 




New and improved PotCom class 



uf I*** this /me U 

import j ava . util . ArrayLis t ; • / 0V ^ ^Ik about 




public class DotCom { 



private ArrayLis t<String> locationCells; 

// private int numOfHits; * L-\s*t 'thS't holds S'bfwy* 

// don't need that now i \ _ cJ-wiwa AWaV *t° ^ 



Cha«y tv* Sfc™* 

public void setLocationCells (ArrayLis t<String> loc ) { , 

locationCells = loc; V|# A ar^ VAW ' cvx 

) 



, -the 



public String checkYourself (String userlnput) { 

String result = "miss"; 

int index = locationCells . indexOf (userlnput) ; 
if (index >= 0) { > 



v-e Wr\s a - 1 • 



locationCells . remove (index) ; 



if (locationCells . isEmpty () ) { 

result = "kill"; 

} else { 

result = "hit"; 

} // close if 

} // close outer if 



/-f index is areal, ,, 

'< 'remove ii ‘‘finitely i h i he 

s_ |t ^e list is emyiy, this 

v y,as the killing Wo'"! 



return result; 
} // close method 
} // close class 
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making the DotComBust 



Let's build the REAL game: 
"Sink a Pot Com" 



We’ve been working on the ‘simple’ version, but now 
let’s build the real one. Instead of a single row, we’ll 
use a grid. And instead of one DotCom, we’ll use 
three. 



Goal: Sink all of the computer’s Dot Corns in the 
fewest number of guesses. You’re given a rating level 
based on how well you perform. 

Setup: When the game program is launched, the 
computer places three Dot Corns, randomly, on the 
virtual 7x7 grid. When that’s complete, the game 
asks for your first guess. 



How you play: We haven’t learned to build a GUI 
yet, so this version works at the command-line. The 
computer will prompt you to enter a guess (a cell), 
which you’ll type at the command-line (as “A 3 ”, “C 5 ”, 
etc.) . In response to your guess, you’ll see a result at 
the command-line, either “hit”, “miss”, or ‘You sunk 
Pets.com” (or whatever the lucky Dot Com of the day 
is). When you’ve sent all three Dot Corns to that big 
404 in the sky, the game ends by printing out your 
rating. 
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You’re going to build the 
Sink a Dot Com game, with 
a 7 x 7 grid and three 
Dot Corns. Each Dot Com 
takes up three cells. 
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get to know the Java API 



What weeds to change? 

We have three classes that need to change: the 
DotCom class (which is now called DotCom instead of 
SimpleDotCom), the game class (DotComBust) and the 
game helper class (which we won’t worry about now) . 

Q DotCom class 

© Add a name variable 

to hold the name of the DotCom 
(“Pets.com”, “Go 2 .com”, etc.) so each Dot- 
Com can print its name when it’s killed (see 
the output screen on the opposite page). 

Q DotComBust class (the game) 

© Create three DotComs instead of one. 

© Give each of the three DotComs a name. 

Call a setter method on each DotCom 
instance, so that the DotCom can assign the 
name to its name instance variable. 



DotComBust class continued... 

© Put the DotComs on a grid rather than 
just a single row, and do it for all three 
DotComs. 

This step is now way more complex than 
before, if we’re going to place the DotComs 
randomly. Since we’re not here to mess 
with the math, we put the algorithm for 
giving the DotComs a location into the 
GameHelper (Ready-bake) class. 

© Check each user guess with all three 
DotComs , instead of just one. 

© Keep playing the game (i.e accepting 
user guesses and checking them with the 
remaining DotComs) until there are no more 
live DotComs. 

© Get out of main. We kept the simple one in 
main just to... keep it simple. But that’s not 
what we want for the real game. 



3 Classes: 




^ and to make 
\aVT — rc o> 




DotComBust 




DotCom 




GameHelper 


The game class. 

Makes DotComs, 
gets user input, 
plays until all Dot- 
Coms are dead 




The actual 
DotCom objects. 

DotComs know their 
name, location, and 
how to check a user 
guess for a match. 




The helper class 

(Ready-Bake). 

It knows how to 
accept user com- 
mand-line input, 
and make DotCom 
locations. 



5 Objects: 




o 

DotComBust 



DotCom 



Plus 4 

ArrayLists: 1 for 
the DotComBust 
and 1 for each 
of the 3 DotCom 
objects. 

GameHelper 
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detailed structure of the game 



Who docs what iw the PotCow&ust ga m 

(and when) 




DotComBust 

The game 
class. 




object 



The main() method 
in the DotComBust 
class instantiates the 
DotComBust object that 
does all the game stuff. 





DotComBust 

object 



The DotComBust (game) 
object instantiates an 
instance of GameHelper, 
the object that will help 
the game do its work. 





GameHelper 

object 



DotComBust 

object 



ArrayList object (to 
hold DotCom objects) 



The DotComBust object 
instantiates an ArrayList 
that will hold the 3 DotCom 
objects. 
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get to know the Java API 




DotComBust 

object 



ArrayList object to 
hold DotCom objects 



DotCom 

objects 



The DotComBust object 
creates three DotCom 
objects (and puts them in 
the ArrayList) 




DotComBust 

object 



The DotComBust object gives each of the Dot- 
Com objects a location (which the DotComBust 
got from the helper object) like "A2", "B2", 
etc. Each DotCom object puts his own three 
location cells in an ArrayList 



ArrayList object 
(to hold DotCom 
cell locations) 

ArrayList 
object 



The DotComBust object asks the 
helper object for a location for a 
DotCom (does this 3 times, one for 
each DotCom) 



ArrayList 

object 



ArrayList object to 
hold DotCom objects 



DotCom 

objects 




The DotComBust object asks the helper 
object for a user guess (the helper 
prompts the user and gets input from 
the command-line) 

q 



DotComBust 

object 



ArrayList 

object 



And so the game continues... get- 
ting user input, asking each DotCom 
to check for a match, and continuing 
until all DotComs are dead 



ArrayList object to 
hold DotCom objects 



DotCom 

objects 



ArrayList 

object 



The DotComBust object loops through the list 
of DotComs, and asks each one to check the user 
guess for a match. The DotCom checks its locations 
ArrayList and returns a result ("hit", "miss", etc.) 



ArrayList object 
(to hold DotCom 
cell locations) 
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the DotComBust class (the game) 



prep code test code 



DotComBust 



GameHelper helper 
ArrayList dotComsList 
int numOfGuesses 



setUpGame() 

startPlaying() 

checkUserGuess() 

finishGameQ 



Prep code for the real PotCow&ust class 



The DotComBust class has three main jobs: set up the game, play the game 
until the DotComs are dead, and end the game. Although we could map 
those three jobs directly into three methods, we split the middle job (play the 
game) into two methods, to keep the granularity smaller. Smaller methods 
(meaning smaller chunks of functionality) help us test, debug, and modify 
the code more easily. 



DECLARE and instantiate the GameHelper instance variable, named helper. 



Variable 

Declarations 



DECLARE and instantiate an A rrayList to hold the list of DotComs (initially three) Call it 

dotComsList. 

DECLARE an int variable to hold the number of user guesses (so that we can give the user a 
score at the end of the game). Name it numOfGuesses and set it to 0. 



Method 

Declarations 



DECLARE a setUpGamef) method to create and initialize the DotCom objects with names 
and locations. Display brief instructions to the user 

DECLARE a startPlayingf) method that asks the player for guesses and calls the 
checkUserGuess() method until all the DotCom objects are removed from play. 

DECLARE a checkUserGuessf) method that loops through all remaining DotCom objects and 
calls each DotCom object’s checkYourself() method. 

DECLARE a finishGamef) method that prints a message about the user’s performance, based 
on how many guesses it took to sink all of the DotCom objects. 



Method 

Implementations 



METHOD: void setUpGamef) 

II make three DotCom objects and name them 
CREATE three DotCom objects. 

SET a name for each DotCom. 

ADD the DotComs to the dotComsList ( the ArrayList). 

REPEAT with each of the DotCom objects in the dotComsList array 

CALL the placeDotComf) method on the helper object, to get a randomly-selected 
location for this DotCom (three cells, vertically or horizontally aligned, on a 7 X 7 grid). 

SET the location for each DotCom based on the result of the placeDotComf) call. 

END REPEAT 
END METHOD 
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get to know the Java API 



prep code 



test code 



real code 



Method implementations continued: 



METHOD: void startPlayingQ 

REPEAT while any DotComs exist 

GET user input by calling the helper getUserlnput() method 
EVALUATE the user’s guess by checkUserGuess() method 
END REPEAT 
END METHOD 



METHOD: void checkUserGuessfString userGuess) 

II find out if there’s a hit (and kill) on any DotCom 

INCREMENT the number of user guesses in the numOfGuesses variable 

SET the local result variable (a String ) to “miss”, assuming that the user’s guess will be a miss. 

REPEAT with each of the DotObjects in the dotComsList array 

EVALUATE the user’s guess by calling the DotCom object’s checkYourselff) method 
SET the result variable to “hit” or “kill” if appropriate 
IF the result is “kill”, REMOVE the DotCom from the dotComsList 
END REPEAT 

DISPLAY the result value to the user 
END METHOD 



METHOD: void fmishGame() 

DISPLAY a generic “game over” message, then: 
IF number of user guesses is small, 

DISPLAY a congratulations message 

ELSE 

DISPLAY an insulting one 
END IF 

END METHOD 






J WWI jjw'VI IVll 



How should we go from prep code to the 
final code? First we start with test code, and 
then test and build up our methods bit by 
bit. We won't keep showing you test code 
in this book, so now it's up to you to think 
about what you'd need to know to test these 



methods. And which method do you test 
and write first? See if you can work out some 
prep code for a set of tests. Prep code or 
even bullet points are good enough for this 
exercise, but if you want to try to write the 
real test code (in Java), knock yourself out. 
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the DotComBust code (the game) 



prep code 

import java. util.*; 
public class DotComBust { 

(^private GameHelper helper = new GameHelper () ; 

^^iprivate ArrayList<DotCom> dotComsList = new ArrayList<DotCom> ( ) ; 
f private int numOfGuesses = 0; 

private void setUpGame() { 

// first make some dot corns and give them locations 
DotCom one = new DotCom (); 
one . setName ("Pets . com") ; 

DotCom two = new DotCom (); 
two . setName ("eToys . com") ; 

DotCom three = new DotCom() , 
three . setName ("Go2 . com") ; 
dotComsList . add (one) ; 
dotComsList . add (two) ; 
dotComsList . add (three) ; 



(D 



in your pencil 



Annotate the code 
yourself! 

Match the 
annotations at the 
bottom of each page 
with the numbers 
in the code. Write 
the number in the 
slot in front of the 
corresponding 
annotation. 

You’ll use each 
annotation just once, 
and you’ll need all of 
the annotations. 



<D 



System. out .println ("Your goal is to sink three dot corns."); 

System. out .println ("Pets . com, eToys.com, Go2.com"); 

System. out .println ("Try to sink them all in the fewest number of guesses") ; 

for (DotCom dotComToSet : dotComsList) { 

ArrayList<String> newLocation = helper .placeDotCom (3) ; 
dotComToSet . setLocationCells (newLocation) ; 

} // close for loop 
} // close setUpGame method 

private void startPlaying ( ) { 

while (! dotComsList . isEmpty () ) { © 

String userGuess = helper . getUserlnput ("Enter a guess"); © 
checkUserGuess (userGuess) ; 

} // close while 
finishGame ( ) ; ® 

} // close startPlaying method 



, ■ a,a\'^ A ei w * er m?wt 



ask tke kelyev tov a PACom Uaiion 

veyeat vAk eatk PotCo«> >» tke list 



'ifrt ' ,a ' r ' a 



► \\ 

ms'trudtio^s -fov “fVom helper * ^ J Us ^ 3°^ 



ou»r oy/h 



^kUscir^ucss method 



user 



wdNC V 

.tall our oum -fihis^a^e method ^*ames, 



.ake tw PotCo- S iSt 

and stick «"> '« the ' 
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"list is HOT em ? ty 
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get to know the Java API 



prep code 



private void checkUser Guess (String userGuess) { 

numOfGuesses++; © 

String result = "miss"; (l2) 

for (DotCom dotComToTest : dotComsList) { 

result = dotComToTest . checkYourself (userGuess) ; ^4) 
if (result . equals ("hit" ) ) { 

break; ^5) 



if 



(result . equals ("kill") ) { 

dotComsList . remove (dotComToTest) , 
break; 



© 



} 

} // close for 

System. out .println (result) ; 
} // close method 



Whatever you do, 
DON’T turn the 
page! 

Not until you’ve 
finished this 
exercise. 

Our version is on 
the next page. 



private void finishGame ( ) { 

System. out .println ("All Dot Corns are dead! Your stock is now worthless.") 
if (numOfGuesses <= 18 ) { 

System. out . println ("It only took you " + numOfGuesses + " guesses."); 
System. out . println (" You got out before your options sank."); 

} else { 

System. out . println ("Took you long enough. "+ numOfGuesses + " guesses."); 
System. out . println ("Fish are dancing with your options."); 

} 

} // close method 




public static void main (String [] args) { 
DotComBust game = new DotComBust ( ) ; ^9) 
game . setUpGame ( ) ; (20) 

game . startPlaying ( ) ; /£\ 

} // close method 



“ f e f d ; s ° him out of ih e 

PotCon list then get out ot the loop 



.repeat with all P°tComs in the list pv .int ^ 

pw»,t a message telling the result -for 
USOr ^ ow ^ d\d ih -the game the user 

- - — r tell the game objedt 

tk< . w, -u. w 1,4 ^ tfc< 

_ask the PotCom to thetk the user guess, 
looking hr a hit (or kill) 

dv-eate the game objedt 



assume 

^->.te// the 1 . 1 

.get out of the loop 3 5 ^e p/^y | oop ^ 0 s ^t the 
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the DotComBust code (the game) 



prep code test code 



import java. util.*; 
public class DotComBust 



•tv* ^ 

private GameHelper helper = new GameHelper () ; 
private ArrayList<DotCom> dot 
private int numOf Guesses = 0; 






private ArrayList<DotCom> dotComsList = new ArrayList<DotCom> ( ) ; /\/|akc 3* ^vv 3 Vt- , S‘t 

OKL-V totCorr. °h £t y: 
objects) • 



Make ttree 
m tke birvjM' 



private void setUpGame() { 

// first make some dot corns and give them locations 
DotCom one = new DotCom (); 
one . setName ("Pets . com") ; 

DotCom two = new DotCom (); 
two . setName ("eToys . com") ; 

DotCom three = new DotCom () 
three . setName ("Go2 . com") ; 
dotComsList . add (one) ; 
dotComsList . add (two) ; 
dotComsList . add (three) ; 

System. out .println ("Your goal is to sink three dot corns."), 
System. out .println ("Pets . com, eToys.com, Go2.com"); 



P vint bvifrf 

ms'tvudtio^s -Cov user. 



System. out .println ("Try to sink them all in the fewest number of guesses") ; 

for (DotCom dotComToSet : dotComsList) { < — Refeat witk eatk VoiCo* m tke list- 

Ask tke kelfev -fov a 

ArrayList<String> newLocation = helper .placeDotCom (3) ; < DotCor* location (an 

ArraYUs-t ok Strings). 



dotComToSet . setLocationCells (newLocation) ; ^ ,, . 

M 3 °i ko! h e \Xl o£ailon Y° 



} // close for loop 
} // close setUpgame method 



private void startPlaying ( ) { ,, 

As U* as tte VolCon M to KOT e^v hke ! ^a«s NOT, its 

while (! dotComsList . isEmpty () ) { t same as (dotComsList 3 SC * 

String userGuess = helper . getUserlnput ("Enter a guess") ; ^ usev input 
checkUserGuess (userGuess) ; ^ 

'"^^^s^uess method. 

} // close while 

finishGame () ; ^ Call our ow n -Pinish^ame method. 

} // close startPlaying method 
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get to know the Java API 



prep code test code 




private void checkUser Guess (String userGuess) { 

numOfGuesses++; ^ tkc number o£ jesses tbe user bas made 

String result = "miss"; ^ * assume it s a miss , unless bold otherwise 

for (DotCom dotComToTest : dotComsList) { ^ repeat wrtb all DotCom 



result = dotComToTest . checkYourself (userGuess) ; 
if (result . equals ("hit") ) { 

break 

} 

if (result . equals ("kill") ) { 

■this 



ask ike DoiCom io (MttY ike : 
g*ess, looking for a kii (or kilU 



A — ' 9 e ^ ^ke loop early, ho poin-fc 

^ m testing the others 



dotComsList . remove 
break; 



(dotComToTest) ; tvJjK* dead> 50 Lke him o«i of ihe 

PoiComs lisi ihe* get out of ihe loop 



} // close for 



System, out .print in (result) ; result -for -the user 

} // close method 



pri«i a message iellmg ihe 
wer hoy, he did in ihe game 



private void finishGame ( ) { 

System. out .println ("All Dot Corns are dead! Your stock is now worthless." 
if (numOfGuesses <= 18) { 

System. out . println ("It only took you " + numOfGuesses + " guesses."); 
System. out .println (" You got out before your options sank."); 

} else { 

System. out . println ("Took you long enough. "+ numOfGuesses + " guesses 
System. out . println ("Fish are dancing with your options"); 




} // close method 



public static void main 
DotComBust game = new 
game . setUpGame ( ) ; 
game . startPlaying ( ) ; 

} // close method 



(String[] args) 
DotComBust ( ) ; C- 

<r 

^ 



_ ^ ie ike 9^ e »tj eti 
e I the game ob\ ei i 1 . 

p* 1 * Pty loop ^ the «, 



game 
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the DotCom code 



prep code test code 



The final version of the 
PotCom class 



import java. util.*; 

public class DotCom { 

private ArrayList<String> locationCells; 
private String name; 



PotCom's instate variables: 

- an ArrayLis-t of dell locations 

— the DotCom* S name 



/ A ^4-4-^v- method that updates 

public void setLocationCells (ArrayList<String> loc) { \ th C p tC *s location 

(Random lodat.cn provided by 
tbe ^amettelper pladePotComl ) 
method) 



locationCells = loc; 



public void setName (String n ) ^4 Yowr basid setter method 

name = n; 

} The ArravUst indent ) method m 

adtion' 1+ the user guess is one ok the 
entries in the ArrayList, inde*W 

public String checkYourself (String userlnput) { Vill return its ffrrSyl****' lotation- n 

String result = "miss"; not> inde%0-f( ) will V"etuV"n I- 

int index = locationCells . indexOf (userlnput ) ; 
if (index >= 0) { 

locationCells . remove (index) ; 



Using /WayList's vemovef ) method to delete an entvy- 



if (locationCells . isEmpty () ) { 

result = "kill"; 



Using the is£mpty( ) method to see it all 
of the lodations have been guessed 



System. out . println ("Ouch ! You sunk " + name + 
} else { 



( ") ; 



result = "hit"; 
} // close if 

} // close if 
return result; 

} // close method 
} // close class 



Tell the 



when a DotCom has been 



sunk. 



or -hit' or -hi 
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get to know the Java API 



Super Powerful Boolean Expressions 



So far, when we've used boolean expressions for our loops or 
if tests, they've been pretty simple. We will be using more 
powerful boolean expressions in some of the Ready-Bake code 
you're about to see, and even though we know you wouldn't 
peek, we thought this would be a good time to discuss how to 
energize your expressions. 

‘And’ and ‘Or’ Operators ( &&, || ) 

Let's say you're writing a chooseCamera( ) method, with lots of rules 
about which camera to select. Maybe you can choose cameras 
ranging from $50 to $1000, but in some cases you want to limit the 
price range more precisely. You want to say something like: 

'If the price range is between $300 and $400 then choose X.' 

if (price >= 300 && price < 400) { 
camera = "X"; 

} 

Let's say that of the ten camera brands available, you have some 
logic that applies to only a few of the list: 

if (brand. equals ("A") | | brand. equals ("B") ) { 
// do stuff for only brand A or brand B 

} 

Boolean expressions can get really big and complicated: 

if ( (zoomType. equals ("optical") && 

(zoomDegree >= 3 && zoomDegree <= 8)) | 
(zoomType. equals ("digital") && 

(zoomDegree >= 5 && zoomDegree <= 12))) { 
//do appropriate zoom stuff 

} 

If you want to get really technical, you might wonder about the 
precedence of these operators. Instead of becoming an expert 
in the arcane world of precedence, we recommend that you use 
parentheses to make your code clear. 



Not equals ( != and ! ) 

Let's say that you have a logic like, "of the ten available 
camera models, a certain thing is true for all but one." 

if (model != 2000) { 

// do non-model 2000 stuff 

} 

or for comparing objects like strings... 

if (! brand. equals ("X") ) { 

// do non-brand X stuff 

} 

Short Circuit Operators ( && , || ) 

The operators we've looked at so far, &&and ||, are 
known as short circuit operators. In the case of &&, 
the expression will be true only if both sides of the && 
are true. So if the JVM sees that the left side of a && 
expression is false, it stops right there! Doesn't even 
bother to look at the right side. 

Similarly, with ||, the expression will be true if either side is 
true, so if the JVM sees that the left side is true, it declares 
the entire statement to be true and doesn't bother to 
check the right side. 

Why is this great? Let's say that you have a reference 
variable and you're not sure whether it's been assigned 
to an object. If you try to call a method using this null 
reference variable (i.e. no object has been assigned), you'll 
get a NullPointerException. So, try this: 

if (refVar != null && 

refVar. isValidType( ) ) { 

// do 'got a valid type' stuff 

} 

Non Short Circuit Operators ( & , | ) 

When used in boolean expressions, the & and | operators 
act like their && and || counterparts, except that 
they force the JVM to always check both sides of the 
expression. Typically, & and | are used in another context, 
for manipulating bits. 
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Ready-bake: GameHelper 




Readj-fcake 

Cods 



import java.io.*; 
import java. util.*; 



This is the helper class for the game. Besides the user input method 
(that prompts the user and reads input from the command-line), the 
helper's Big Service is to create the cell locations for the DotComs. 
If we were you, we'd just back away slowly from this code, except 
to type it in and compile it. We tried to keep it fairly small to you 
wouldn't have to type so much, but that means it isn't the most 
readable code. And remember, you won't be able to compile the 
DotComBust game class until you have this class. 



public class GameHelper { 

private static final String alphabet = "abcdefg"; 

private int gridLength = 7; 

private int gridSize = 49; 

private int [] grid = new int [gridSize] ; 

private int comCount = 0; 

public String getUserlnput (String prompt) { 
String inputLine = null; 

System. out . print (prompt + " ") ; 

try { 

But feredReader is = new But f eredReader ( 
new InputStreamReader (System. in) ) ; 
inputLine = is . readLine ( ) ; 

if (inputLine . length ( ) == 0 ) return null; 
} catch (IOException e) { 

System. out .println ("IOException : " + e) ; 

} 

return inputLine . toLowerCase ( ) ; 



No- te : For e*-tra drcdi-t, you miejh-t 
-try 'uK-dommeivt'm^ the 
System. ou-t pr'm-tO^)^ m the 
fladePotC om( ) method, just 
to wat^h it u/or kj These print 
statements will let you "dheat” 
by you the lodation of the 

DotComs, but it y/ill help you test it- 



public ArrayList<Strmg> placeDotCom (int comSize) { 

ArrayList<String> alphaCells = new ArrayList<String> ( ) ; 



String [] alphacoords = new String [comSi 
String temp = null; 
int [] coords = new int [ comSize ] ; 
int attempts = 0; 
boolean success = false; 
int location = 0; 

comCount++ ; 
int incr = 1; 

if ( (comCount % 2) == 1) { 

incr = gridLength; 

} 

while ( ! success & attempts++ < 200 ) { 

location = (int) (Math . random ( ) * gridSi: 

//System. out .print (" try " + location) ; 
int x = 0; 
success = true; 

while (success && x < comSize) { 
if (grid [location] == 0) { 

152 chapter 6 



// holds 'f6' type coords 
// temporary String for concat 
// current candidate coords 
// current attempts counter 
// flag = found a good location ? 

// current starting location 

// nth dot com to place 

// set horizontal increment 

// if odd dot com (place vertically) 

// set vertical increment 



// main search loop (32) 

) ; // get random starting point 

// nth position in dotcom to place 
// assume success 

// look for adjacent unused spots 
// if not already used 
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get to know the Java API 



® Read}-fcake 
Cods 



C-aweHelper class code continued... 



coords [x++] = location; 
location += incr; 
if (location >= gridSize) { 
success = false; 



// save location 
// try 'next' adjacent 
// out of bounds - 'bottom' 
// failure 



if (x>0 && (location % gridLength == 0) ) { 

success = false; 

} 

} else { 

// System. out .print (" used " + location) ; 
success = false; 



// out of bounds - right edge 
// failure 

// found already used location 
// failure 



} 



} 



/ / end while 



int x = 0; 
int row = 0; 
int column = 0; 

// System. out .println ("\n") ; 
while (x < comSize) { 
grid [coords [x] ] = 1; 

row = (int) (coords [x] / gridLength); 

column = coords [x] % gridLength; 

temp = String . valueOf (alphabet . charAt (column)); 



// turn location into alpha coords 



// mark master grid pts . as 'used' 
/ / get row value 
// get numeric column value 
// convert to alpha 



alphaCells . add (temp . concat (Integer . toString (row) ) ) ; 
x++; 

// System. out .print (" coord "+x+" = " + alphaCells . get (x-1) ) ; 






// System. out .println ("\n") ; 



return alphaCells; 

} 

} 
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API packages 



Using the Library (the Java API) 

You made it all the way through the DotComBust game, 
thanks to the help of ArrayList. And now, as promised, 




To use a class in the API, you 
have to know which package 
the class is in. 



Every class in the Java library belongs to a package. 
The package has a name, like javax. Swing (a 
package that holds some of the Swing GUI classes 
you’ll learn about soon). ArrayList is in the package 
called java. Util, which surprise surprise, holds a 
pile of utility classes. You’ll learn a lot more about 
packages in chapter 16 , including how to put your 
own classes into your own packages. For now though, 
we’re just looking to ^some of the classes that come 
with Java. 

Using a class from the API, in your own code, is 
simple. You just treat the class as though you wrote 
it yourself... as though you compiled it, and there it 
sits, waiting for you to use it. With one big difference: 
somewhere in your code you have to indicate the full 
name of the library class you want to use, and that 
means package name + class name. 

Even if you didn’t know it, you’ve already been using 
classes from a package. System ( System, out. prin tin), 
String, and Math (Math.random()), all belong to the 
java.lang package. 
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get to know the Java API 



You have to know the full name* 
of the class you want to use in 
your code. 



ArrayList is not th e full name of ArrayList, just as ‘Kathy’ 
isn’t a full name (unless it’s like Madonna or Cher, but we 
won’t go there). The full name of ArrayList is actually: 



P^kage name 



java. util .ArrayList 

\ 



t\a» 



^a«.e 



You have to tell Java which ArrayList you 
want to use. You have two options: 



Q IMPORT 

Put an import statement at the top of your source code file: 

import java. util .ArrayList; 
public class MyClass { . . . } 




Why does there have to 
be a full name? Is that the only 
purpose of a package? 

A. 

Jr \* Packages are important 
for three main reasons. First, they 
help the overall organization of a 
project or library. Rather than just 
having one horrendously large 
pile of classes, they're all grouped 
into packages for specific kinds 
of functionality (like GUI, or data 
structures, or database stuff, etc.) 

Second, packages give you a name- 
scoping, to help prevent collisions 
if you and 12 other programmers 
in your company all decide to 
make a class with the same name. 

If you have a class named Set and 
someone else (including the Java 
API) has a class named Set, you 
need some way to tell the JVM 
which Set class you're trying to use. 



OR 



Q TYPE 

Type the full name everywhere in your code. Each time 
you use it. Anywhere you use it. 



When you declare and/or instantiate it: 

j ava .util. Ar rayLi s t<Dog> list = new j ava .util. Ar r ayLi s t<Dog> ( ) ; 



Third, packages provide a level of 
security, because you can restrict 
the code you write so that only 
other classes in the same package 
can access it. You'll learn all about 
that in chapter 16. 

OK, back to the name 
collision thing. How does a full 
name really help? What's to 
prevent two people from giving a 
class the same package name? 



When you use it as an argument type: 

public void go (java . util . ArrayList<Dog> list) 



When you use it as a return type: 

public j ava. util .Ar rayLi st<Dog> foo() { . . . } 



A* 

^\-Java has a naming convention 
that usually prevents this from 
happening, as long as developers 
adhere to it. We'll get into that in 
more detail in chapter 16. 



*Unless the class is in the java.lang package. 
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when arrays aren’t enough 



Where’d that ‘x’ come from? 

(or, what does it mean when 
a package starts with javax?) 

In the first and second versions of Java (1 .02 
and 1.1), all classes that shipped with Java (in 
other words, the standard library) were in packages 
that began with java. There was always java. long, of course 
— the one you don't have to import. And there was java.net, 
java. io, java. util (although there was no such thing as ArrayList 
way back then), and a few others, including the java.awt 
package that held GUI-related classes. 

Looming on the horizon, though, were other packages not 
included in the standard library. These classes were known as 
extensions, and came in two main flavors: standard, and not 
standard. Standard extensions were those that Sun considered 
official, as opposed to experimental, early access, or beta 
packages that might or might not ever see the light of day. 

Standard extensions, by convention, all began with an 'x' 
appended to the regular java package starter. The mother of all 
standard extensions was the Swing library. It included several 
packages, all of which began with javax.swing. 

But standard extensions can get promoted to first-class, ships- 
with-Java, standard-out-of-the-box library packages. And that's 
what happened to Swing, beginning with version 1 .2 (which 
eventually became the first version dubbed 'Java 2'). 

"Cool" everyone thought (including us). "Now everyone who has 
Java will have the Swing classes, and we won't have to figure 
out how to get those classes installed with our end-users." 

Trouble was lurking beneath the surface, however, because 
when packages get promoted, well of COURSE they have to 
start with java, not javax. Everyone KNOWS that packages in 
the standard library don't have that "x" and that only extensions 
have the"x" So, just (and we mean just) before version 1.2 
went final, Sun changed the package names and deleted the 
"x" (among other changes). Books were printed and in stores 
featuring Swing code with the new names. Naming conventions 
were intact. All was right with the Java world. 

Except the 20,000 or so screaming developers who realized 
that with that simple name change came disaster! All of their 
Swing-using code had to be changed! The horror! Think of all 
those import statements that started with javax... 

And in the final hour, desperate, as their hopes grew thin, the 
developers convinced Sun to "screw the convention, save our 
code" The rest is history. So when you see a package in the 
library that begins with javax, you know it started life as an 
extension, and then got a promotion. 
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BULLET POINTS 

■ ArrayList is a class in the Java API. 

■ To put something into an ArrayList, use add(). 

■ To remove something from an ArrayList use 

remove(). 

■ To find out where something is (and if it is) in an 
ArrayList, use indexOf(). 

■ To find out if an ArrayList is empty, use 

isEmpty(). 

■ To get the size (number of elements) in an 
ArrayList, use the size() method. 

■ To get the length (number of elements) in a 
regular old array, remember, you use the length 

variable. 

■ An ArrayList resizes dynamically to what- 
ever size is needed. It grows when objects 
are added, and it shrinks when objects are 
removed. 

■ You declare the type of the array using a type 
parameter, which is a type name in angle 
brackets. Example: ArrayList<Button> means 
the ArrayList will be able to hold only objects of 
type Button (or subclasses of Button as you’ll 
learn in the next couple of chapters). 

■ Although an ArrayList holds objects and not 
primitives, the compiler will automatically “wrap” 
(and “unwrap” when you take it out) a primi- 
tive into an Object, and place that object in the 
ArrayList instead of the primitive. (More on this 
feature later in the book.) 

■ Classes are grouped into packages. 

■ A class has a full name, which is a combina- 
tion of the package name and the class name. 
Class ArrayList is really java. util. Array List. 

■ To use a class in a package other than java, 
lang, you must tell Java the full name of the 
class. 

■ You use either an import statement at the top of 
your source code, or you can type the full name 
every place you use the class in your code. 
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get to know the Java API 



tFereiareno 

Dunib Questions 



SJ- Does import make my 
class bigger? Does it actually 
compile the imported class or 
package into my code? 

Perhaps you're a C pro- 
grammer? An import is not the 
same as an include. So the 
answer is no and no. Repeat after 
me:"an import statement saves 
you from typing.'That's really it. 
You don't have to worry about 
your code becoming bloated, or 
slower, from too many imports. 

An import is simply the way you 
give Java the full name of a class. 



OK, how come I never had 
to import the String class? Or 
System? 

Remember, you get the 
java.lang package sort of "pre- 
imported"for free. Because 
the classes in java.lang are so 
fundamental, you don't have to 
use the full name. There is only 
one java.Iang.String class, and one 
java.Iang.System class, and Java 
darn well knows where to find 
them. 



% Do I have to put my own 
classes into packages? How do I 
do that? Can I do that? 



In the real world (which 
you should try to avoid), yes, you 
will want to put your classes into 
packages. We'll get into that in 
detail in chapter 16. For now, we 
won't put our code examples in a 
package. 



£2 

^ * sikC 

Rnc„r 



, iv*. 

■khveads 

w ■% ■ mr k. Wii 4-0 

Roses are red, 
a Pples are ripe , 

lf y°u don't imp 0rt 

you'" just have to type 

Vou must tell j ava tho . 

Package. An lmp " s ln java.lang 
° r Package at the top of vo 1 f ° r the ^ 
easy way. Otherwise you 1 S ° UrCe co * is the 



One more time, in the unlikely 
event that you don’t already 
have this down: 




you are here ► 157 



Head First Java, 2nd Edition. Head First Java, 2nd Edition, ISBN: 0596009208 

Prepared for e.simons@icarin.fiuc.org, Eduard Simons 

Copyright © 2005 Bert Bates and Kathy Sierra. This PDF is made available for personal use only during the relevant subscription term, subject to the Safari Terms of Service. Any other use 
requires prior written consent from the copyright owner. Unauthorized use, reproduction and/or distribution are strictly prohibited and violate applicable laws. All rights reserved. 





getting to know the API 



“ Good to know there's an Array List in 
the java.util package. But by myself, how 
would I have figured that out?" 

- Julia, 31, hand model 



How to play with the API 

Two things you want to know: 

0 What classes are in the library? 

A Once you find a class, how do 
you know what it can do? 

Browse a Book 





JAVA 



IN A NUTSHELL 



A Desktop Quick Reference 
O’REILLY* Durui 



Use the HTML API docs 




Purftwm * 
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get to know the Java API 



Browse a Book 



JAVA 



Flipping through a 
reference book is the 
best way to find out 
what's in the Java 
library. You can easily 
stumble on a class that 
looks useful, just by 
browsing pages. 



thss 






java . util. Currency 

Returned By: java.text.DecimalFonnat.getCurrency(), java.text.DecimalFormatSymbols.getCurrencyO. 
java.text.Numberformat.ggtCunrencyO, Currency.getlnstanceO 



padkage name 
t \ass 



we -talk about later.) 9 



Date 



Java 1.0 



: java.util 



cloncablc serializable comparable 






This class represents dates and times and lets you work with them in a system-indepen- 
dent way. You can create a Date by specifying the number of milliseconds from the 
epoch (midnight GMT. January 1st, 1970) or the year, month, date, and, optionally, the 
hour, minute, and second. Years are specified as the number of years since 1900. If you 
call the Date constructor with no arguments, the Date is initialized to the current time 
and date. The instance methods of the class allow you to get and set the various date 
and time fields, to compare dates and times, and to convert dates to and from string 
representations. As of Java 1.1, many of the date methods have been deprecated in 
favor of the methods of the Calendar class. 



| Object | 1 Date | 

|Ckineable| [ Comparable | [Serializable] 



public class Date implements Cloneable. Comparable. Serializable { 
// Public Constructors 
public Date( ); 
public Date(longdafe); 

# public Date(Strings); 

# public Date(int year, int month, int date); 

t public Date(int year, int month, int date, int hrs, int min); 
i public Date(mt year, int month, int date, int hrs, int min, int sec); 
// Property Accessor Methods (by property name) 
public long getTime 
public void $etTlme(long time): 

// Public Instance Methods 

public boolean after(|ava util.Date when); 
public boolean before(java.util.Date when); 
u public mt compareTo(java.util.Date anotherDate ); 

// Methods Implementing Comparable 
1.2 public mt compareTo(Object o); 

// Public Methods Overriding Object 
public Object clone(): 
public boolean equals(Object oft/): 
public int hashCodeO: 
public String toString 
// Deprecated Public Methods 
« public int getDate( ) 

# public int getDay(): 

i public mt getHoursi ); 
r public int getMinutes/) 

# public int getMonth 

# public mtgetSeconds(): 

# public ; rt getTimezoneOff set;); 
i public int getYear; ) 

9 public static long parse($tring s); 
i public void setDate(int date); 

9 public void setHours/int hours); 

9 public void setMinutes(int minutes); 

9 public void setMonthimt month); 
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using the Java API documentation 



0 Use the HTML API docs 

Java comes with a fabulous set of online docs 
called, strangely, the Java API. They’re part of 
a larger set called the Java 5 Standard Edition 
Documentation (which, depending on what 
day of the week you look, Sun may be refer- 
ring to as “Java 2 Standard Edition 5 . 0 ”), and 
you have to download the docs separately; 
they don’t come shrink-wrapped with the Java 
5 download. If you have a high-speed internet 
connection, or tons of patience, you can also 
browse them atjava.sun.com. Trust us, you 
probably want these on your hard drive. 

The API docs are the best reference for get- 
ting more details about a class and its methods. 
Let’s say you were browsing through the refer- 
ence book and found a class called Calendar, 
in java. util. The book tells you a little about it, 
enough to know that this is indeed what you 
want to use, but you still need to know more 
about the methods. 



The reference book, for example, tells you 
what the methods take, as arguments, and what 
they return. Look at ArrayList, for example. 

In the reference book, you’ll find the method 
indexOf(), that we used in the DotCom class. 
But if all you knew is that there is a method 
called indexOf() that takes an object and re- 
turns the index (an int) of that object, you still 
need to know one crucial thing: what happens 
if the object is not in the ArrayList? Looking 
at the method signature alone won’t tell you 
how that works. But the API docs will (most of 
the time, anyway) . The API docs tell you that 
the indexOf() method returns a -1 if the object 
parameter is not in the ArrayList. That’s how 
we knew we could use it both as a way to check 
if an object is even in the ArrayList, and to get 
its index at the same time, if the object was 
there. But without the API docs, we might have 
thought that the indexOf() method would 
blow up if the object wasn’t in the ArrayList. 



© 

padcaje. 

f d seleci (click ii) 

, * the U i„ ihe 

£*£?*»* Y*** 
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ArrayList (Java 2 Platform SE S.O) 
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| + | <A* http://java.sun.eom/j2se/l.5.0/docs/api/ 


© Google 






java.sql 
l ava-text . 

iava.utll * 

iava.util.concurrent 
lava.util-concurrent.att 
lava.util.concurrent.loc 
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Queue 

RandomAccess 

Set 

SortedMap 

SortedSet 

Classes 

AbstractCollection 

AbstractList 

AbstraptMap 

AbstractQueue 

AbstractSeauentialLisi 

AbstractSet 

ArrayList 

Arrays 

BitSet 

Calendar 

Collections 

Currency 

Date 

Dictionary 



Fields inherited from class java. util AbstractList 



ArrayList ( ) 

Constructs an empty list with an initial capacity of 



Constructor Summary 



. - )S ^ert a" 

i r.l i nn <? extends E> c) 1 



Constructs a list containing the elements of the sp* 
returned by the collection's iterator. 



ArrayList (int initialCapacity ) 






0 



, or d*tK o* 


Method Summary i 


boolean 


iddiEoi a ^ \ 

Appends the specified clement to the cjU irf t ^ 


void 


(JiCv®" 

add (int index, E element) 

Inserts the specified clement at the spc-. ifd \ 


boolean 


addAll ( Collection<? extends E> cl 

Appends all of the elements in the speedkd Conecuon to Hie end of uiis list, m 
the order that they arc returned by the specified Collection's Iterator. 


boolean 


addAll lint index. Collections extends E> cl 

Inserts all of the elements in the specified Collection into this list, starting at the 
snecified position 
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get to know the Java API 




Code Magnets 



Can you reconstruct the code snippets to make a 
working Java program that produces the output 
listed below? NOTE: To do this exercise, you need 
one NEW piece of info — if you look in the API for 
ArrayList, you'll find a second add method that takes 
two arguments: 

add(int index. Object o) 

It lets you specify to the 

ArrayList where to put the object you're adding. 



a. remove (2) ; 




( a -add(o 

' u ' zero") • 

I a * add (i 

one") ; 



public static void printAL (ArrayList<String> al) { 



File" Edit 


Window Help Dance 


1 


% java ArrayListMagnet 


zero 


one 


two 


three 


zero 


one 


three 


four 


zero 


one 


three 


four 4.2 


zero 


one 


three 


four 4.2 
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puzzle: crossword 




JavaCr®s$ 7.0 



How does this crossword puzzle help you learn 
Java? Well, all of the words are Java related 
(except one red herring). 

Hint: When in doubt, remember ArrayList. 



Across 

1 . 1 can't behave 

6. Or, in the courtroom 

7. Where it's at baby 

9. A fork's origin 

1 2. Grow an ArrayList 

13. Wholly massive 

14. Value copy 

16. Notan object 

1 7. An array on steroids 

1 9. Extent 

21. 19's counterpart 

22. Spanish geek snacks (Note: This has 
nothing to do with Java.) 

23. For lazy fingers 

24. Where packages roam 









1 






2 










3 




4 






5 


















6 














7 












































8 








9 


10 










11 








12 










13 














14 


































15 












16 








17 




















18 


























19 










20 




21 








































22 










23 


































24 















Down 

2. Where the Java action is. 

3. Addressable unit 

4. 2nd smallest 

5. Fractional default 

8. Library's grandest 

1 0. Must be low density 

1 1 . He's in there somewhere 

15. As if 

16. dearth method 

1 8. What shopping and arrays have in common 

20. Library acronym 

21 . What goes around 



More Hints: 

e 6m>|euu s,8H ‘8 1 
jsnAejJV >|uiqi ■ 91 
aAiijiLiud -01 $ t 7 
jsn/tejjv >|U!i|i •£ 
iaiqepujaAO s,jeq/\/\ Z 

UMOQ 



sjazpadde qsmeds - BABf jnoqe jon zz 
juajxa s/bjjv ‘IZ 
aAjjjiuud UOLULU 03 ‘9 1 
jsr|AejJV>|U!qi ' L 

S 01 J 0 UBA 8 ' L 

ssojdv 
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get to know the Java API 






Exercise Solutions 



import java . util . * ; 



L 



public class ArrayListMagnet { 



1 



| File Edit 


Window Help Dance 


1 


% java ArrayListMagnet 


zero 


one 


two 


three 


zero 


one 


three 


four 


zero 


one 


three 


four 4.2 


zero 


one 


three 


four 4.2 



public static void main (String [] args) { 

ArrayList<String> a = new ArrayList<String> () ; 

a. add (0 /'zero") ; 
a. add(l , "one") ; 




public static void printAL (ArrayList<String> al) { 



for (String element : al) { 



L 



1 



o° 



System. out .print (element + 

} 

System. out .pr in tin (" ") ; 
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puzzle answers 





answers 
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Sharpen 



Across 



your pencil 

Write your OWN set of clues! Look at each word, and try to 
write your own clues. Try making them easier, or harder, or 
more technical than the ones we have. 



1 ._ 
6. _ 
7 . _ 
9 . _ 
12 . 

13 . 

14 . 
16 . 
17. 
19. 
21 . 
22 . 

23 . 

24 . 



Down 

2 . 

3 . 

4 . 

5. 

8 . 

10 . 

11 . 

15. 

16. 

18. 

20 . 

21 . 
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7 inheritance and polymorphism 




\ 



Better Living in 
Objectville 



We were underpaid, ) 
overworked coders 'till we 
tried the Polymorphism Plan. But 
thanks to the Plan, our future is 
^ bright. Yours can be too! 



Plan your programs with the future in mind. If there were a way to write 
Java code such that you could take more vacations, how much would it be worth to you? What 
if you could write code that someone else could extend, easily? And if you could write code 
that was flexible, for those pesky last-minute spec changes, would that be something you're 
interested in? Then this is your lucky day. For just three easy payments of 60 minutes time, you 
can have all this. When you get on the Polymorphism Plan, you'll learn the 5 steps to better class 
design, the 3 tricks to polymorphism, the 8 ways to make flexible code,and if you act now — a 
bonus lesson on the 4 tips for exploiting inheritance. Don't delay, an offer this good will give 
you the design freedom and programming flexibility you deserve. It's quick, it's easy, and it's 
available now. Start today, and we'll throw in an extra level of abstraction! 
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the power of inheritance 



Chair Wars Revisited... 



Remember way back in chapter 2, when Larry ( procedural guy) 
and Brad (OO guy) were vying for the Aeron chair? Let’s look at 
a few pieces of that story to review the basics of inheritance. 

LARRY: You’ve got duplicated code! The rotate procedure 
is in all four Shape things. It’s a stupid design. You have to 
maintain four different rotate “methods”. How can that 
ever be good? 

BRAD: Oh, I guess you didn’t see the final design. Let me 
show you how OO inheritance works, Larry. 



Square 




Circle 




Triangle 




Amoeba 


rotate() 




rotate() 




rotate() 




rotateQ 


playSoundQ 




playSoundQ 




playSoundQ 




playSoundQ 



I looked at what all four 
classes have in common. 



© 



They're Shapes, and they all rotate and 
playSound. So I abstracted out the 
common features and put them into a 
new class called Shape. 




© 



superclass 




You can read this as, “Square inherits from Shape”, 
“Circle inherits from Shape”, and so on. I removed 
rotate() and playSound() from the other shapes, so now 
there’s only one copy to maintain. 

The Shape class is called the superclass of the other four 
classes. The other four are the subclasses of Shape. The 
subclasses inherit the methods of the superclass. In other 
words, if the Shape class has the functionality, then the 
subclasses automatically get that same functionality. 






7 ^ 

subclasses 



Then I linked the other 
four shape classes to 
the new Shape class, 
in a relationship called 
inheritance. 




Square 




Circle 




Triangle 




Amoeba 
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inheritance and polymorphism 



What about the Amoeba rotateO? 



How can amoeba do something different if it inherits its 
functionality from the Shape class? 

BRAD: That’s the last step. The Amoeba class overrides the 
methods of the Shape class. Then at runtime, the JVM knows 
exactly which rotate() method to run when someone tells the 
Amoeba to rotate. 



LARRY: Wasn’t that the whole problem here — that the amoeba shape 
had a completely different rotate and playSound procedure? 





O 

I wade the Amoeba class override the 
rotateO and playSoundO methods 
of the superclass Shape. Overriding 
just weans that a subclass redefines 
one of its inherited methods when 
it needs to change or extend the 
behavior of that method. 

K 

Overriding methods 











How would you represent a house cat and a tiger, in an 
inheritance structure. Is a domestic cat a specialized 
version of a tiger? Which would be the subclass and 
which would be the superclass? Or are they both 
subclasses to some other class? 

How would you design an inheritance structure? What 
methods would be overridden? 

Think about it. Before you turn the page. 
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the way inheritance works 



Understanding Inheritance 

When you design with inheritance, you put common code in 
a class and then tell other more specific classes that the 
common (more abstract) class is their superclass. When one 
class inherits from another, the subclass inherits from the 
superclass. 

In Java, we say that the subclass extends the superclass. 

An inheritance relationship means that the subclass inherits 
the members of the superclass. When we say “members of 
a class” we mean the instance variables and methods. 

For example, if PantherMan is a subclass of SuperHero, the 
PantherMan class automatically inherits the instance variables 
and methods common to all superheroes including suit, 
tights, specialPower, useSpecialPower ( ) and 
so on. But the PantherMan subclass can add new 
methods and instance variables of its own, and it can 
override the methods it inherits from the superclass 
SuperHero. 




PantherMan, though, has specific requirements for his suit 
and special powers, so useSpecialPower ( ) and 
putOnSuit ( ) are both overridden in the PantherMan 
class. 

Instance variables are not overridden because they 
don’t need to be. They don’t define any special behavior, so a 
subclass can give an inherited instance variable any value it 
chooses. PantherMan can set his inherited tights to 
purple, while FriedEggMan sets his to white. 
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inheritance and polymorphism 



An inheritance example: 

public class Doctor { 

boolean worksAtHospital ; 

void treatPatient ( ) { 

// perform a checkup 

} 

} 



public class FamilyDoctor extends Doctor { 

boolean makesHouseCalls ; 
void giveAdvice() { 

// give homespun advice 

} 



} 



public class Surgeon extends Doctor{ 

void treatPatient ( ) { 

// perform surgery 

} 



void makelncision ( ) { 

// make incision (yikes!) 



} 




superclass 




nr 






jvui j-'uuvni 



How many instance variables does 
Surgeon have? 

How many instance variables does 
FamilyDoctor have? 

How many methods does Doctor have?_ 

How many methods does Surgeon have? 

How many methods does FamilyDoctor 
have? 



Can a FamilyDoctor do treatPatient()? _ 
Can a FamilyDoctor do makelncision()? 
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designing for inheritance 



Let's design the inheritance tree for 
an Animal simulation program 

Imagine you’re asked to design a simulation program that 
lets the user throw a bunch of different animals into an 
environment to see what happens. We don’t have to code the 
thing now, we’re mostly interested in the design. 

We’ve been given a list of some of the animals that will be 
in the program, but not all. We know that each animal will 
be represented by an object, and that the objects will move 
around in the environment, doing whatever it is that each 
particular type is programmed to do. 

And we want other programmers to be able to add new 
kinds of animals to the program at any time . 

First we have to figure out the common, abstract 
characteristics that all animals have, and build those 
characteristics into a class that all animal classes can extend. 



O Look for objects that have common 
attributes and behaviors. 





What do these six types have in 
common? This helps you to abstract 
out behaviors, (step 2) 




How are these types related? This 
helps you to define the 
tree relationships (step 
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inheritance and polymorphism 



Using inheritance to avoid 
duplicating code in subclasses 

We have five instance variables: 




picture - the file name representing the JPEG of this animal 

food - the type of food this animal eats. Right now, there 
can be only two values: meat or grass. 

hunger - an int representing the hunger level of the animal. 
It changes depending on when (and how much) the 
animal eats. 

boundaries - values representing the height and width of 
the ‘space’ (for example, 640 x 480 ) that the animals will 
roam around in. 



Design a class that represents 
the common state and behavior. 

These objects are all animals, so 
we'll make a common superclass 
called Animal. 

We'll put in methods and instance 
variables that all animals might 
need. 



location - the X and Y coordinates for where the animal is 
in the space. 

We have four methods : 

makeNoise () - behavior for when the animal is supposed to 
make noise. 

eat( ) - behavior for when the animal encounters its 
preferred food source, meat or grass. 

sleep () - behavior for when the animal is considered asleep. 

roam() - behavior for when the animal is not eating or 
sleeping (probably just wandering around waiting to bump 
into a food source or a boundary) . 



Animal 

picture 
food 
hunger 
boundaries 
location 
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designing for inheritance 



Po all animals cat the same way? 



Assume that we all agree on one thing: the instance 
variables will work for all Animal types. A lion will 
have his own value for picture, food (we’re thinking 
meat), hunger, boundaries, and location. A hippo 
will have different values for his instance variables, 
but he’ll still have the same variables that the other 
Animal types have. Same with dog, tiger, and so on. 
But what about behavior ? 



O Decide if a subclass 

needs behaviors (method 
implementations) that are specific 
to that particular subclass type. 



Which methods should we override? 

Does a lion make the same noise as a dog? Does 
a cat eat like a hippo? Maybe in your version, but 
in ours, eating and making noise are Animal-type- 
specific. We can’t figure out how to code those 
methods in such a way that they’d work for any 
animal. OK, that’s not true. We could write the 
makeNoise() method, for example, so that all it does 
is play a sound file defined in an instance variable 
for that type, but that’s not very specialized. Some 
animals might make different noises 
for different situations (like one 
for eating, and another when 
bumping into an enemy, etc.) 

So just as with the Amoeba 
overriding the Shape class rotate () 
method, to get more amoeba-specific (in 
other words, unique ) behavior, we’ll have 
to do the same for our Animal subclasses. 




Looking at the Animal class, 
we decide that eat() and 
makeNoise() should be overridden 
by the individual subclasses. 



In the dog 

community, barking is an 
important part of our cultural 
identity. We have a unique sound, 
and we want that diversity to 
be recognized and respected. 



Animal 



picture 

food 

hunger 

boundaries 

location 



makeNoise() 

eat() 



sleep() 

roam() 



y-oan.0 tan s-tay $enevtt. 



1 72 chapter 7 



Head First Java, 2nd Edition. Head First Java, 2nd Edition, ISBN: 0596009208 

Prepared for e.simons@icarin.fiuc.org, Eduard Simons 

Copyright © 2005 Bert Bates and Kathy Sierra. This PDF is made available for personal use only during the relevant subscription term, subject to the Safari Terms of Service. Any other use 
requires prior written consent from the copyright owner. Unauthorized use, reproduction and/or distribution are strictly prohibited and violate applicable laws. All rights reserved. 



inheritance and polymorphism 



Looking for more inheritance 
opportunities 

The class hierarchy is starting to shape up. We 
have each subclass override the makeNoise() and 
eat() methods, so that there’s no mistaking a Dog 
bark from a Cat meow (quite insulting to both 
parties). And a Hippo won’t eat like a Lion. 

But perhaps there’s more we can do. We have to 
look at the subclasses of Animal, and see if two 
or more can be grouped together in some way, 
and given code that’s common to only that new 
group. Wolf and Dog have similarities. So do 
Lion, Tiger, and Cat. 



O 

Look for more opportunities to use 
abstraction, by finding two or more 
subclasses that might need common 
behavior. 

We look at our classes and see 
that Wolf and Dog might have some 
behavior in common, and the same goes 
for Lion, Tiger, and Cat. 



• C IA 0YV 

Tacv, a** ,0^°^ 




W °'f Doc, L / . 

iher e '? So **>»«... 





Wolf 






Cat I 


makeNoise() 

eat() 




makeNoise() 

eat() 


I rT n 
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designing for inheritance 




Finish the class hierarchy 

Since animals already have an organizational 
hierarchy (the whole kingdom, genus, phylum 
thing), we can use the level that makes the most 
sense for class design. We'll use the biological 
"families" to organize the animals by making a 
Feline class and a Canine class. 

We decide that Canines could use a common 
roam() method, because they tend to move in 
packs. We also see that Felines could use a 
common roam() method, because they tend to 
avoid others of their own kind. Well let Hippo 
continue to use its inherited roam() method— 
the generic one it gets from Animal. 

So we’re done with the design for now; we’ll 
come back to it later in the chapter. 



Animal 



picture 

food 

hunger 

boundaries 

location 
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inheritance and polymorphism 



Which method is called? 



The Wolf class has four methods. One 
inherited from Animal, one inherited from 
Canine (which is actually an overridden 
version of a method in class Animal), and 
two overridden in the Wolf class. When 
you create a Wolf object and assign it to 
a variable, you can use the dot operator 
on that reference variable to invoke all 
four methods. But which version of those 
methods gets called? 



Animal 



make a new Wol-f objedt 
dalls the version in Wol-P 



Wolf w = new Wolf(); 
w . makeNoise ( ) ; 



makeNoise() 

eat() 

sleep() 

roam() 



dalls -the version in Canine w • roam ( ) ; 



dalls -the version in Wol-f w . eat ( ) ; 



dalls -the version in Animal w . sleep ( ) ; 



When you call a method on an object 
reference, you’re calling the most specific 
version of the method for that object type. 

In other words, the lowest one wins! 




“Lowest” meaning lowest on the 
inheritance tree. Canine is lower than 
Animal, and Wolf is lower than Canine, 
so invoking a method on a reference 
to a Wolf object means the JVM starts 
looking first in the Wolf class. If the JVM 
doesn’t find a version of the method in 
the Wolf class, it starts walking back up 
the inheritance hierarchy until it finds a 
match. 
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practice designing an inheritance tree 



Pesigning m Inheritance Tree 



superclass 
(more abstract) 



Class 


Superclasses 


Subclasses 


Clothing 


— 


Boxers. Shin 


Ho\crs 


Clothing 




Shirt 


Clothing 




Inheritance Table 

Q ( 

X 


— mV 

Sharpen y 

-■'■'■j 

in the last two columns 


"A. 

Find the relalionships that make sense. Fill 


Class 


Superclasses 


Subclasses 



Clothing 



subclasses 

(more specific) 



/\ 



Musician 



Ri h k Siar 



Fan 



Bass Phwr 



Concert Hantst 



Hint; not everything cm be connected to something efea. 
Hint, you're allowed to add to or change the classes fisted. 



Busters 



Shin 



Inheritance Class Diagram 



Draw an inheritance diagram here. 




You said that the JVM starts 
walking up the inheritance tree, 
starting at the class type you invoked 
the method on (like the Wolf example 
on the previous page). But what 
happens if the JVM doesn't ever find 
a match? 



A- 

Jr \ m Good question! But you don't 
have to worry about that. The compiler 
guarantees that a particular method 
is callable for a specific reference type, 
but it doesn't say (or care) from which 
class that method actually comes from 
at runtime. With the Wolf example, the 
compiler checks for a sleepO method, 
but doesn't care that sleepO is actually 
defined in (and inherited from) class 
Animal. Remember that if a class 
inherits a method, it has the method. 



Where the inherited method is defined 
(in other words, in which superclass 
it is defined) makes no difference to 
the compiler. But at runtime, the JVM 

will always pick the right one. And 
the right one means , the most specific 
version for that particular object. 
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inheritance and polymorphism 



Using IS~A and HAS-A 



Remember that when one class 
inherits from another, we say that the 
subclass extends the superclass. When 
you want to know if one thing should 
extend another, apply the IS-A test. 

Triangle IS-A Shape, yeah, that works. 
Cat IS-A Feline, that works too. 
Surgeon IS-A Doctor, still good. 

Tub extends Bathroom, sounds 
reasonable. 

Until you apply the IS-A test. 

To know if you’ve designed your types 
correctly, ask, “Does it make sense to 
say type X IS-A type Y?” If it doesn’t, 
you know there’s something wrong 
with the design, so if we apply the IS-A 
test, Tub IS-A Bathroom is definitely 
false. 

What if we reverse it to Bathroom 
extends Tub? That still doesn’t work, 
Bathroom IS-A Tub doesn’t work. 



T 



Does it make sense to 
say a Tub IS-A Bathroom? Or a 
Bathroom IS-A Tub? Well it doesn't to 
me. The relationship between my Tub 
and my Bathroom is HAS-A. Bathroom 
HAS-A Tub. That means Bathroom 
has a Tub instance variable. 



V 






39 



Tub and Bathroom are related, but 
not through inheritance. Tub and 
Bathroom are joined by a HAS-A 
relationship. Does it make sense to 
say “Bathroom HAS-A Tub”? If yes, 
then it means that Bathroom has a 
Tub instance variable. In other words, 
Bathroom has a reference to a Tub, but 
Bathroom does not extend Tub and 
vice-versa. 



Bathroom 

Tub bathtub; 
SinktheSink; 



Tub j 

intsize; 

Bubbles b; 

Bubbles 

■ • * int radius; 

int colorAmt; 




Bathroom HAS-A Tub and Tub HAS-A Bubbles. 
But nobody inherits from (extends) anybody else. 
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exploiting the power of objects 



Put wait! There's more! 

The IS-A test works anywhere in the inheritance tree. If your 
inheritance tree is well-designed, the IS-A test should make 
sense when you ask any subclass if it IS-A any of its supertypes. 



If class B extends class A, class B IS-A class A. 

This is true anywhere in the inheritance tree. If 
class C extends class B, class C passes the IS-A 
test for both B and A. 



Canine extends Animal 
Wolf extends Canine 
Wolf extends Animal 

Canine IS-A Animal 
Wolf IS-A Canine 
Wolf IS-A Animal 



Animal 



makeNoise() 

eat() 

sleep() 

roam() 




Wolf 



makeNoise() 

eat() 




With an inheritance tree like the 
one shown here, you’re always 
allowed to say “Wolf extends 
Animal” or “Wolf IS-A Animal”. 

It makes no difference if Animal 
is the superclass of the superclass 
of Wolf. In fact, as long as Animal 
is somewhere in the inheritance 
hierarchy above Wolf, Wolf IS-A 
Animal will always be true. 

The structure of the Animal 
inheritance tree says to the world: 

“Wolf IS-A Canine, so Wolf can do 
anything a Canine can do. And 
Wolf IS-A Animal, so Wolf can do 
anything an Animal can do.” 

It makes no difference if Wolf 
overrides some of the methods 
in Animal or Canine. As far as 
the world (of other code) is 
concerned, a Wolf can do those 
four methods. How he does them, 
or in which class they ’re overridden 
makes no difference. A Wolf can 
makeNoise(), eat(), sleep (), and 
roam() because a Wolf extends 
from class Animal. 
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inheritance and polymorphism 



How do you know if you've got 
your inheritance right? 

There’s obviously more to it than what we’ve 
covered so far, but we’ll look at a lot more OO 
issues in the next chapter (where we eventually 
refine and improve on some of the design work 
we did in this chapter) . 

For now, though, a good guideline is to use the 
IS-A test. If “X IS-AY” makes sense, both classes 
(X and Y) should probably live in the same 
inheritance hierarchy. Chances are, they have 
the same or overlapping behaviors. 

Keep in mind that the 
inheritance IS-A relationship 
works in only one direction! 

Triangle IS-A Shape makes sense, so you can 
have Triangle extend Shape. 

But the reverse — Shape IS-A Triangle — does 
not make sense, so Shape should not extend 
Triangle. Remember that the IS-A relationship 
implies that if X IS-A Y, then X can do anything 
a Y can do (and possibly more). 



MaV-c 



vt Sfc* 




, re d,»oKts“'““* Mls „,tru e . 



Roses ore r 



v^aV' neSS ° , v k-AY must make s 

X ex' 




Sharpen your pencil 



Put a check next to the relationships that 
make sense. 

D Oven extends Kitchen 

□ Guitar extends Instrument 

□ Person extends Employee 

□ Ferrari extends Engine 

□ FriedEgg extends Food 

□ Beagle extends Pet 

□ Container extends Jar 

□ Metal extends Titanium 

□ GratefulDead extends Band 

□ Blonde extends Smart 
D Beverage extends Martini 



Hint: apply the IS-A test 
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who inherits what 




V: So we see how a subclass gets 
to inherit a superclass method, but 
what if the superclass wants to use 
the subclass version of the method? 

A superclass won't necessarily 
know about any of its subclasses. 

You might write a class and much 
later someone else comes along and 
extends it. But even if the superclass 
creator does know about (and wants 
to use) a subclass version of a method, 
there's no sort of reverse or backwards 
inheritance. Think about it, children 
inherit from parents, not the other way 
around. 



O: In a subclass, what if I want to 
use BOTH the superclass version and 
my overriding subclass version of a 
method? In other words, I don't want 
to completely replace the superclass 
version, I just want to add more stuff 
to it. 



You can do this! And it's an 
important design feature. Think of the 
word "extends" as meaning, "I want 
to extend the functionality of the 
superclass" 

public void roam() { 
super. roam () ; 

// my own roam stuff 



You can design your superclass 
methods in such a way that they 
contain method implementations 
that will work for any subclass, even 
though the subclasses may still need 
to 'append' more code. In your subclass 
overriding method, you can call the 
superclass version using the keyword 
super. It's like saying, "first go run the 
superclass version, then come back and 
finish with my own code..." 

this tails the inherited version ot 
voamO, then tomes batk to do 

7 o*r ovm subtlass-speti+it tode 



} 




Who gets the Porsche, who gets the porcelain? 
(how to know what a subclass can 
inherit from its superclass) 




A subclass inherits members of the 
superclass. Members include instance 
variables and methods, although later in 
this book we’ll look at other inherited members. A 
superclass can choose whether or not it wants a 
subclass to inherit a particular member by the level of 
access the particular member is given. 



There are four access levels that we’ll cover in this book. 
Moving from most restrictive to least, the four access 
levels are: 



private default protected public 



Access levels control who sees what, and are crucial 
to having well-designed, robust Java code. For now we’ll 
focus just on public and private. The rules are simple for 
those two: 

public members are inherited 
private members are not inherited 



When a subclass inherits a member, it is as if the 
subclass defined the member itself. In the Shape 
example, Square inherited the rotate ( ) and 
pi ay Sound ( ) methods and to the outside world (other 
code) the Square class simply has a rotate ( ) and 
playSound ( ) method. 

The members of a class include the variables and 
methods defined in the class plus anything inherited 
from a superclass. 
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inheritance and polymorphism 



Whew designing with inheritance, 
are you using or abusing? 

Although some of the reasons behind these rules won’t be 
revealed until later in this book, for now, simply knowing a 
few rules will help you build a better inheritance design. 



DO use inheritance when one class is a more specific type 
of a superclass. Example: Willow is a more specific type of 
Tree, so Willow extends Tree makes sense. 



DO consider inheritance when you have behavior 
(implemented code) that should be shared among 
multiple classes of the same general type. Example: 

Square, Circle, and Triangle all need to rotate and play 
sound, so putting that functionality in a superclass Shape 
might make sense, and makes for easier maintenance and 
extensibility. Be aware, however, that while inheritance is 
one of the key features of object-oriented programming, 
it’s not necessarily the best way to achieve behavior reuse. 
It’ll get you started, and often it’s the right design choice, 
but design patterns will help you see other more subtle 
and flexible options. If you don’t know about design 
patterns, a good follow-on to this book would be Head First 
Design Patterns. 



DO NOT use inheritance just so that you can reuse 
code from another class, if the relationship between the 
superclass and subclass violate either of the above two 
rules. For example, imagine you wrote special printing 
code in the Alarm class and now you need printing code 
in the Piano class, so you have Piano extend Alarm so that 
Piano inherits the printing code. That makes no sense! A 
Piano is not a more specific type of Alarm. (So the printing 
code should be in a Printer class, that all printable objects 
can take advantage of via a HAS-A relationship.) 



DO NOT use inheritance if the subclass and superclass 
do not pass the IS-A test. Always ask yourself if the subclass 
IS-A more specific type of the superclass. Example: Tea IS- 
A Beverage makes sense. Beverage IS-A Tea does not. 



— BULLET POINTS 

■ A subclass extends a superclass. 

■ A subclass inherits all public instance 
variables and methods of the superclass, but 
does not inherit the private instance variables 
and methods of the superclass. 

■ Inherited methods can be overridden; instance 
variables cannot be overridden (although they 
can be redefined in the subclass, but that’s 
not the same thing, and there’s almost never a 
need to do it.) 

■ Use the IS-A test to verify that your 
inheritance hierarchy is valid. If X extends Y, 
then X IS-A Y must make sense. 

■ The IS-A relationship works in only one 
direction. A Hippo is an Animal, but not all 
Animals are Hippos. 

■ When a method is overridden in a subclass, 
and that method is invoked on an instance of 
the subclass, the overridden version of the 
method is called. (The lowest one wins.) 

■ If class B extends A, and C extends B, class 
B IS-A class A, and class C IS-A class B, and 
class C also IS-A class A. 
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exploiting the power of objects 



So what does all this 
inheritance really buy you? 



You get a lot of OO mileage by designing 
with inheritance. You can get rid of duplicate 
code by abstracting out the behavior common 
to a group of classes, and sticking that code 
in a superclass. That way, when you need to 
modify it, you have only one place to update, 
and the change is magically reflected in all the 
classes that inherit that behavior. Well, there’s 
no magic involved, but it is pretty simple: 
make the change and compile the class 
again. That’s it. You don’t have to touch the 
subclasses! 

Just deliver the newly-changed superclass, and 
all classes that extend it will automatically use 
the new version. 

A Java program is nothing but a pile of classes, 
so the subclasses don’t have to be recompiled 
in order to use the new version of the 
superclass. As long as the superclass doesn’t 
break anything for the subclass, everything’s 
fine. (We’ll discuss what the word ‘break’ 
means in this context, later in the book. For 
now, think of it as modifying something in 
the superclass that the subclass is depending 
on, like a particular method’s arguments or 
return type, or method name, etc.) 



0 You avoid duplicate 
code. 

Put common code in one place, and let 
the subclasses inherit that code from a 
superclass. When you want to change that 
behavior, you have to modify it in only 
one place, and everybody else (i.e. all the 
subclasses) see the change. 




You define a common 
protocol for a group of 
classes. 

Urn, what 
the heck does 
THAT mean? 



© 
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inheritance and polymorphism 



Inheritance lets you guarantee that 
all classes grouped under a certain 
supertype have all the methods that 
the supertype has* 

In other words, you define a cownon protocol for a 
set of classes related through inheritance. 

When you define methods in a superclass, that can be 
inherited by subclasses, you’re announcing a kind of 
protocol to other code that says, “All my subtypes (i.e. 
subclasses) can do these things, with these methods 
that look like this...” 

In other words, you establish a contract. 

Class Animal establishes a common protocol for all 
Animal subtypes: 



Animal 



makeNoise() 

eat() 

sleep() 

roam() 



\ . n (Jo these * OVA " 
a »d vet** 



And remember, when we say any Animal , we mean 
Animal and any class that extends from Animal. Which 
again means, any class that has Animal somewhere above it 
in the inheritance hierarchy. 

But we’re not even at the really cool part yet, because 
we saved the best — polymorphism — for last. 

When you define a supertype for a group of classes, 
any subclass of that supertype can be substituted where the 
supertype is expected. 

Say, what? 

Don’t worry, we’re nowhere near done explaining it. 
Two pages from now, you’ll be an expert. 



*When we say “all the methods” we mean “all the inheritable methods”, which 
for now actually means, “all the public methods”, although later we’ll refine that 
definition a bit more. 



And I care because... 

Because you get to take advantage of 
polymorphism. 



Which matters to me 
because... 

Because you get to refer to a subclass 
object using a reference declared as the 
supertype. 

And that means to me... 

You get to write really flexible code. 
Code that's cleaner (more efficient, 
simpler). Code that's not just easier to 
develop, but also much, much easier to 
extend, in ways you never imagined at 
the time you originally wrote your code. 

That means you can take that tropical 
vacation while your co-workers update 
the program, and your co-workers might 
not even need your source code. 

You'll see how it works on the next page. 

We don't know about you, but 
personally, we find the whole 
tropical vacation thing 
particularly motivating. 
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the way polymorphism works 



The 3 steps of object 
declaration and assignment 



To see how polymorphism 
works, we have to step back 
and look at the way we 
normally declare a reference 
and create an object... 




Dog myDog = new Dog() ; 



O Declare a reference 
variable 



Dog myDog = new Dog() ; 

Tells the JVM to allocate space for a 
reference variable. The reference variable 
is, forever, of type Dog. In other words, 
a remote control that has buttons to 
control a Dog, but not a Cat or a Button 
or a Socket. 




0 Create an object 

Dog myDog = new Dog ( ) ; 

Tells the JVM to allocate space for 
a new Dog object on the garbage 
collectible heap. 

Dog object 



O Link the object 
and the reference 

Dog myDog = new Dog() ; 

Assigns the new Dog to the refer- 
ence variable myDog. In other words, 

program the remote control . 



Dog 
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inheritance and polymorphism 



The important point is that the 
reference type AND the object 
type are the same. 




In this example, both are Dog. 






These two are the same type- The re-ferente 
variable type is declared as Dog, and the object 
is created as new DogO. 



But with polymorphism, the 
reference and the object can 
be different. 




Animal myDog = new DogO ; 



Animal 



^,9 ob'f^ 



These two are NOT ihe same type- The 
re(eret\te variable type is dedlared as Anima l, 
but the objedt is dreated as *eu/_DogO. 
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polymorphism in action 



With polymorphism, the reference 
type can be a superclass of the 
actual object type. 



When you declare a reference variable, 
any object that passes the IS-A test for the 
declared type of the reference variable 
can be assigned to that reference. In 
other words, anything that extends the 
declared reference variable type can 
be assigned to the reference 
variable. This lets you do 
things like make polymorphic 
arrays. 



OK, OK maybe an example will help. 







p et \a^ ^ 



. . j l* <&« '*7 



Animal [] animals = new Animal [5]; 
animals [0] = new Dog() ; 

animals [1] = new Cat() ; 

animals [2] = new Wolf () ; 

animals [3] = new Hippo (); 

animals [4] = new Lion(); 






3" 



awa'f 







But look uibat you jet to do... you da* put AKY 
subdlass ot A»i">al in tbe Animal anna y! 



Ahd here's the best t> / 

A ; a ;°; ^ ton tl i y 7" PW ** 

* ft * p 

for (int i = 0; i < animals . length; i++) { ^// 



every 



animals [i] .eat() ; 






animals [i] .roam() ; 



WKcn V is 0, a Doj is at mde* 0 in the av-vay, so 
you jet the Dojs eatO method- When » »s I, you 
jet the Cat's eatO method 

Same with VoamO. 
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inheritance and polymorphism 



But wait! There’s more! 

You can have polymorphic 
ar guments and return types. 

If you can declare a reference variable 
of a supertype, say, Animal, and assign a 
subclass object to it, say, Dog, think 
that might work when the referenc 
argument to a method... 



class Vet { 

public void giveShot (Animal a) { 



V. giveShot (h); H'PPo's mak e W oise0 nuns 
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} 



a.makeNoise () ; 



// do horrible things to the Animal at 
// the other end of the 'a' parameter 




} 



class PetOwner { 



public void start () { 




The Vet’s 3'weS 
Animal 70“ S We 



jiveShotO method tan take an 7 
awe it- As Us as the objett 



Hippo h = new Hippo ( ) ; 



v . giveShot (d) ; &<** "UeNoiseO runs 



} 



} 
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exploiting the power of polymorphism 



O' 



NOW I get it! If I write 
my code using polymorphic arguments, 
where I declare the method parameter as a 
superclass type, I can pass in any subclass object at 
runtime. Cool. Because that also means I can write my 
code, go on vacation, and someone else can add new 
subclass types to the program and my methods will 
still work... (the only downside is I'm just making life 
easier for that idiot Jim). 



With polymorphism, you can write code that doesn't 
have to change when you introduce new subclass 
types into the program. 



Remember that Vet class? If you write that Vet class using 
arguments declared as type Animal, your code can handle any 
Animal subclass. That means if others want to take advantage of 
your Vet class, all they have to do is make sure their new Animal 
types extend class Animal. The Vet methods will still work, even 
though the Vet class was written without any knowledge of the 
new Animal subtypes the Vet will be working on. 



AIN 



Why is polymorphism guaranteed to work this way? Why is 
it always safe to assume that any subclass type will have the 
methods you think you're calling on the superclass type (the 
superclass reference type you're using the dot operator on)? 
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inheritance and polymorphism 



ciuniL'^ues^pns 



% Are there any practical limits 
on the levels of subclassing? How 
deep can you go? 



% Can you extend any class? Or 
is it like class members where if the 
class is private you can't inherit it... 



If you look in the Java API, 
you'll see that most inheritance 
hierarchies are wide but not deep. 
Most are no more than one or two 
levels deep, although there are 
exceptions (especially in the GUI 
classes). You'll come to realize that 
it usually makes more sense to keep 
your inheritance trees shallow, but 
there isn't a hard limit (well, not one 
that you'd ever run into). 

% Hey, I just thought of 
something... if you don't have 
access to the source code for a class, 
but you want to change the way a 
method of that class works, could 
you use subclassing to do that? To 
extend the "bad" class and override 
the method with your own better 
code? 

Yep.That's one cool feature 
of 00, and sometimes it saves you 
from having to rewrite the class 
from scratch, or track down the 
programmer who hid the source code. 



There's no such thing as a 
private class, except in a very special 
case called an inner class, that we 
haven't looked at yet. But there are 
three things that can prevent a class 
from being subclassed. 

The first is access control. Even though 
a class can't be marked private, a 
class can be non-public (what you 
get if you don't declare the class as 
public). A non-public class can be 
subclassed only by classes in the 
same package as the class. Classes in 
a different package won't be able to 
subclass (or even use, for that matter) 
the non-public class. 

The second thing that stops a class 
from being subclassed is the keyword 
modifier final. A final class means 
that it's the end of the inheritance 
line. Nobody, ever, can extend a final 
class. 

The third issue is that if a class has 
only private constructors (we'll 
look at constructors in chapter 9), it 
can't be subclassed. 



Why would you ever want to 
make a final class? What advantage 
would there be in preventing a class 
from being subclassed? 

Typically, you won't make your 
classes final. But if you need security 
— the security of knowing that the 
methods will always work the way 
that you wrote them (because they 
can't be overridden), a final class 
will give you that. A lot of classes in 
the Java API are final for that reason. 
The String class, for example, is final 
because, well, imagine the havoc if 
somebody came along and changed 
the way Strings behave! 



% Can you make a method final, 
without making the whole class 
final? 



If you want to protect a specific 
method from being overridden, mark 
the method with the finalmodifier. 
Mark the whole class as final if you 
want to guarantee that none of the 
methods in that class will ever be 
overridden. 
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overriding methods 



Keeping the contract: roles for overriding 



When you override a method from a superclass, you’re agreeing to 
fulfill the contract. The contract that says, for example, “I take no 
arguments and I return a boolean.” In other words, the arguments 
and return types of your overriding method must look to the outside 
world exactly like the overridden method in the superclass. 

The methods are the contract. 

If polymorphism is going to work, the Toaster’s version of the 
overridden method from Appliance has to work at runtime. 
Remember, the compiler looks at the reference type to decide 
whether you can call a particular method on that reference. With 
an Appliance reference to a Toaster, the compiler cares only if class 
Appliance has the method you’re invoking on an Appliance reference. 
But at runtime, the JVM looks not at the reference type (Appliance) but 
at the actual Toaster object on the heap. So if the compiler has already 
approved the method call, the only way it can work is if the overriding 
method has the same arguments and return types. Otherwise, 
someone with an Appliance reference will call turnOn () as a no- 
arg method, even though there’s a version in Toaster that takes an 
int. Which one is called at runtime? The one in Appliance. In other 
words, the turnOn (int level) method in Toaster is not an override! 

0 Arguments must be the same, and return 
types must be compatible. 



\i HOT 



TV* 

oMerv'de 

O’t**"* 



Appliance 



boolean turnOn() 
boolean turnOff() 







Toaster 







This w actually a |„,i 



The contract of superclass defines how other code can use a method. 
Whatever the superclass takes as an argument, the subclass over- 
riding the method must use that same argument. And whatever the 
superclass declares as a return type, the overriding method must de- 
clare either the same type, or a subclass type. Remember, a subclass 
object is guaranteed to be able to do anything its superclass declares, 
so it’s safe to return a subclass where the superclass is expected. 



0 The method can’t be less accessible. 



Appliance 



public boolean turnOn() 
public boolean turnOnQ 



That means the access level must be the same, or friendlier. That 
means you can’t, for example, override a public method and make 
it private. What a shock that would be to the code invoking what it 
thinks (at compile time) is a public method, if suddenly at runtime 
the JVM slammed the door shut because the overriding version 
called at runtime is private! 

So far we’ve learned about two access levels: private and public. 
The other two are in the deployment chapter (Release your Code) 
and appendix B. There’s also another rule about overriding related 
to exception handling, but we’ll wait until the chapter on exceptions 
(Risky Behavior) to cover that. 



i \t<^\ 

betake 'f°* 
ft p, WtavAse 







Toaster 



private boolean turnOnf) 
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inheritance and polymorphism 



Overloading a method 



Method overloading is nothing more than having 
two methods with the same name but different 
argument lists. Period. There’s no polymorphism 
involved with overloaded methods! 

Overloading lets you make multiple versions 
of a method, with different argument lists, for 
convenience to the callers. For example, if you 
have a method that takes only an int, the calling 
code has to convert, say, a double into an int 
before calling your method. But if you overloaded 
the method with another version that takes a 
double, then you’ve made things easier for the 
caller. You’ll see more of this when we look into 
constructors in the object lifecycle chapter. 

Since an overloading method isn’t trying to 
fulfill the polymorphism contract defined by its 
superclass, overloaded methods have much more 
flexibility. 



An overloaded method is 
just a different method that 
happens to have the same 
method name. It has nothing 
to do with inheritance and 
polymorphism. An over loaded 
method is NOT the same as 
an over ridden method. 



0 The return types can be 
different. 

You’re free to change the return types in 
overloaded methods, as long as the argument lists 
are different. 

0 You can’t change ONLY the 
return type. 

If only the return type is different, it’s not a 
valid over load — the compiler will assume 
you’re trying to over ride the method. And even 
that won’t be legal unless the return type is 
a subtype of the return type declared in the 
superclass. To overload a method, you MUST 
change the argument list, although you can 
change the return type to anything. 

0 You can vary the access 
levels in any direction. 

You’re free to overload a method with a method 
that’s more restrictive. It doesn’t matter, since the 
new method isn’t obligated to fulfill the contract of 
the overloaded method. 



Legal examples of method 
overloading: 

public class Overloads { 

String uniquelD; 

public int addNums (int a, int b) { 

return a + b; 

} 

public double addNums (double a, double b) { 

return a + b; 

} 

public void setUniquelD (String thelD) { 

// lots of validation code, and then: 
uniquelD = thelD; 

} 

public void setUniquelD (int ssNumber) { 
String numString = "" + ssNumber; 
setUniquelD (numString) ; 

} 
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exercise: Mixed Messages 




the program: 



Mixed 

Messages 

a = 56 

b = 5 ; 1 1 

a = 5; -^>1 65 



A short Java program is listed below. One block of 
the program is missing! Your challenge is to match 
the candidate block of code (on the left), with the 
output that you'd see if the block were inserted. 

Not all the lines of output will be used, and some of 
the lines of output might be used more than once. 
Draw lines connecting the candidate blocks of 
code with their matching command-line output. 



class A { 


class C extends B { 




int ivar = 7; 


void m3 ( ) { 




void ml ( ) { 




System . out . print ( " C 


's m3, "+(ivar + 6)); 


System . out . print ("A's ml, "); 


} 




} 


} 






void m2 ( ) { 








System . out . print ("A's m2, "); 


public class Mixed2 { 




} 


public static void main (String [] args) { 


void m3 ( ) { 




A a = new A( ) ; 




System . out . print ("A's m3, "); 




B b = new B ( ) ; 




} 




C c = new C ( ) ; 




} 




A a2 = new C ( ) ; 


candidate code 


class B extends A { 






goes here 
(three lines) 


void ml ( ) { 








System . out . print ("B's ml, "); 








} 


} 




} 


} 







code 

candidates: 



b. ml ( ) ; 

c. m2( ) | 
a. m3 ( ) ; 

c .ml ( ) ; 
c .m2 ( ) ; 
c .m3 ( ) ; 

a. ml ( ) ; 

b. m2 ( ) ; 

c. m3( ) ; 

a2 .ml ( ) ; 
a2 . m2 ( ) ; 
a2 .m3 ( ) ; 



} 

} 

} 

} 
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output: 

A's ml, A's 
B ' s ml, A's 
A's ml , B' s 
B's ml, A's 
B's ml, C's 
B's ml , A's 

A's ml, A's 



m2 , 


C's 


m3 , 


6 


m2 , 


A's 


m3 , 




m2 , 


A's 


m3 , 




m2 , 


C's 


m3 , 


13 


m2 , 


A's 


m3 , 




m2 , 


C's 


m3 , 


6 


m2 , 


C's 


m3 , 


13 



Head First Java, 2nd Edition. Head First Java, 2nd Edition, ISBN: 0596009208 

Prepared for e.simons@icarin.fiuc.org, Eduard Simons 

Copyright © 2005 Bert Bates and Kathy Sierra. This PDF is made available for personal use only during the relevant subscription term, subject to the Safari Terms of Service. Any other use 
requires prior written consent from the copyright owner. Unauthorized use, reproduction and/or distribution are strictly prohibited and violate applicable laws. All rights reserved. 



inheritance and polymorphism 





BE Compiler 



'Wliicli of the A'B pairs of methods listed on the right, if 
inserted into the classes on the left, would compile and 
produce the output shown? (The A method inserted into 
class Monster, the B method inserted into class Vampire.) 



public class MonsterTestDrive { 

public static void main (String [] args ) { 
Monster [ ] ma = new Monster[3]; 
ma[0] = new Vampire(); 
ma[l] = new Dragon(); 
ma[2] = new Monster(); 
for(int x = 0; x < 3; x++) { 
ma [ x ] . frighten ( x ) ; 

} 

} 

} 

class Monster { 

o 



1 

O 



O 



boolean frighten (int d) { 

System. out .println( "arrrgh" ) ; 
return true; 

} 

boolean frighten (int x) { 

System. out .println( "a bite?"); 

return false; 

} 



2 

o 



o 



boolean frighten (int x) { 

System. out .println( "arrrgh" ) ; 
return true; 

} 

int frighten (int f) { 

System. out .println( "a bite?"); 

return 1 ; 

} 



class Vampire extends Monster { 

o 



} 



class Dragon extends Monster { 
boolean frighten (int degree) { 

System, out .println( "breath fire" ) ; 
return true; 



} 

} 



File Edit Window Help SaveYourself 



% java MonsterTestDrive 
a bite? 
breath fire 
arrrgh 



3 

© 



O 



boolean frighten (int x) { 

System. out .println( "arrrgh" ) ; 
return false; 

} 

boolean scare (int x) { 

System. out .println( "a bite?"); 

return true; 

} 



4 

© 



© 



boolean frighten (int z) { 

System. out .println( "arrrgh" ) ; 
return true; 

} 

boolean frighten ( byte b) { 

System. out .println( "a bite?"); 
return true; 

} 
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puzzle: Pool Puzzle 





Fool Puzzle 



Your job is to take code snippets from the pool and place them into 
the blank lines in the code. You may use the same snippet more 
than once, and you might not need to use all the snippets. Your 
goal is to make a set of classes that will compile and run together 
as a program. Don't be fooled - this one's harder than it looks. 



public class Rowboat { 

public rowTheBoat() { 

Sy stem. out. print( "stroke natasha" ) ; 

} 

} 

public class { 

private int ; 

void ( ) { 

length = len; 

} 

public int getLength( ) { 



} 

public move() { 

Sy stem. out. pr int ( " " ) ; 

} 



public class TestBoats { 

main ( String [ ] args){ 

bl = new Boat(); 

Sailboat b2 = new ( ) ; 

Rowboat = new Rowboat ( ) ; 

b2 . setLength (32); 

bl. (); 

b3. (); 




. move ( ) ; 



public class 
public 



Boat { 



_() { 



System. out . print ( 



OUTPUT: 



drift drift hoist sail 




Rowboat 

Sailboat subclasses 



extends 



Testboats 



return 

continue 

break 



stroke natasha 



rowTheBoat 



move 



setLength 



public 

private 



static 



getLength 
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inheritance and polymorphism 




BE tte Compiler 

Set 1 will work. 




Exercise 

Solutions 

0 



Set 2 will not compile because of Vampire’s return 
type (int). 

The Vampire’s frighten() method (B) is not a legal 
override OR overload of Monster’s frightenQ method. 
Changing ONLY the return type is not enough 
to make a valid overload, and since an int is not 
compatible with a boolean, the method is not a valid 
override. (Remember, if you change ONLY the return 
type, it must be to a return type that is compatible 
with the superclass version’s return type, and then it’s 
an over ride. 

Sets 3 and 4 will compile, but produce: 

arrrgh 

breath fire 

arrrgh 

Remember, class Vampire did not over ride class 
Monster’s frightenQ method. (The frightenQ method 
in Vampire’s set 4 takes a byte, not an int.) 



code 

candidates: 

Mixed 

Messages 



b.ml ( ) ; 
c .m2 ( ) ; 



output: 



a. m3 ( ) ; J ' . 


A' s 


ml , 


A ' s 


m2 , 


C ' s 


m3 , 


6 




B's 


ml , 


A' s 


m2 , 


A' s 


m3 , 




c .ml ( ) ; ^ 
















c . m2 ( ) ; V 


A ' S 


ml , 


B's 


m2 , 


A' s 


m3 , 




c . m3 ( ) ; J 


















B'S 


ml , 


A' s 


m2 , 


C's 


m3 , 


13 


a. ml ( ) ; 
















b . m2 ( ) ; 


B'S 


ml , 


C's 


m2 , 


A' s 


m3 , 




c .m3 ( ) ; ^ 


B'S 


ml , 


A' S 


m2 , 


C's 


m3 , 


6 


a2.ml();J 


></ A' S 


ml , 


A' S 


m2 , 


C's 


m3 , 


13 



a2 .m2 ( ) ; 
a2 .m3 ( ) ; 



you are here ► 195 



Head First Java, 2nd Edition. Head First Java, 2nd Edition, ISBN: 0596009208 

Prepared for e.simons@icarin.fiuc.org, Eduard Simons 

Copyright © 2005 Bert Bates and Kathy Sierra. This PDF is made available for personal use only during the relevant subscription term, subject to the Safari Terms of Service. Any other use 
requires prior written consent from the copyright owner. Unauthorized use, reproduction and/or distribution are strictly prohibited and violate applicable laws. All rights reserved. 



puzzle answers 




public class Rowboat extends Boat { 
public void rowTheBoat() { 

System. out .print ( "stroke natasha" ) ; 

} 

} 

public class Boat { 
private int length ; 
public void setLength ( int len ) { 

length = len; 

} 

public int getLength( ) { 

return length ; 

} 

public void move() { 

System. out .print ( "drift "); 

} 



public class TestBoats { 

public Static void main(String[ ] args ) { 
Boat bi = new Boat( ) ; 

Sailboat b2 = new Sailboat( ) ; 
Rowboat b3 = new Rowboat ( ) ; 



b2 . setLength ( 32 ) ; 



bi.move( ) ; 
b3 . move ( ) ; 
b2.move( ) ; 

} 

} 

public class Sailboat extends Boat { 
public void move () { 

System, out .print ( "hoist Sail ") ; 



} 



OUTPUT: 



drift drift hoist sail 
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8 interfaces and abstract classes 



Serious Polymorphism 




Inheritance is just the beginning. To exploit polymorphism, we need interfaces 
(and not the GUI kind). We need to go beyond simple inheritance to a level of flexibility and 
extensibility you can get only by designing and coding to interface specifications. Some of the 
coolest parts of Java wouldn't even be possible without interfaces, so even if you don't design 
with them yourself, you still have to use them. But you'll want to design with them. You'll need 
to design with them. You'll wonder how you ever lived without them. What's an interface? It's 
a 100% abstract class. What's an abstract class? It's a class that can't be instantiated. What's that 
good for? You'll see in just a few moments. But if you think about the end of the last chapter, 
and how we used polymorphic arguments so that a single Vet method could take Animal 
subclasses of all types, well, that was just scratching the surface. Interfaces are the poly in 
polymorphism. The ab in abstract. The caffeine in Java. 
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designing with inheritance 



Pid we forget about something 
when we designed this? 

The class structure isn’t too bad. We’ve designed 
it so that duplicate code is kept to a minimum, 
and we’ve overridden the methods that we think 
should have subclass-specific implementations. 
We’ve made it nice and flexible from a 
polymorphic perspective, because we can design 
Animal-using programs with Animal arguments 
(and array declarations), so that any Animal 
subtype — including those we never imagined at the 
time we wrote our code — can be passed in and used 
at runtime. We’ve put the common protocol for 
all Animals (the four methods that we want the 
world to know all Animals have) in the Animal 
superclass, and we’re ready to start making new 
Lions and Tigers and Hippos. 



Animal 



picture 

food 

hunger 

boundaries 

location 



makeNoise() 

eat() 



sleep() 

roam() 





eat() 



makeNoise() 

eat() 




makeNoise() 

eat() 
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interfaces and polymorphism 




We know we can say: 

Wolf aWolf = new Wolf(); 



A l/Vol-P rt( trtv\Lt io a 
Wol-f objed-b Wolf 



These -two art the same type- 



And we know we can say 

Animal aHippo = new 



Animal re-fey-ende to 
a Hippo objedt- 




Hippo () ; 



Animal 



These two 



art MOT the same type- 



But here’s where it gets weird: 

Animal anim = new Animal (); 



Animal v-e-fev-ende to 
a y\ Ani^dl objedt- 




what the hedk does a* Ann^dl objedt look like? 
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when objects go bad 




What does a new Animal() 
look like? 



object 



scary objects 




What are the instance variable values? 

Some classes just should not be 
instantiated! 

It makes sense to create a Wolf object or a Hippo 
object or a Tiger object, but what exactly is an 
Animal object? What shape is it? What color, size, 
number of legs... 

Trying to create an object of type Animal is like a 
nightmare Star Trek™ transporter accident. The 
one where somewhere in the beam-me-up process 
something bad happened to the buffer. 

But how do we deal with this? We need an Animal 
class, for inheritance and polymorphism. But we 
want programmers to instantiate only the less 
abstract subclasses of class Animal, not Animal itself. 
We want Tiger objects and Lion objects, not Animal 
objects. 

Fortunately, there’s a simple way to prevent a class 
from ever being instantiated. In other words, to stop 
anyone from saying “new” on that type. By marking 
the class as abstract, the compiler will stop any 
code, anywhere, from ever creating an instance of 
that type. 



You can still use that abstract type as a reference type. 
In fact, that’s a big part of why you have that abstract 
class in the first place (to use it as a polymorphic 
argument or return type, or to make a polymorphic 
array) . 

When you’re designing your class inheritance 
structure, you have to decide which classes are 
abstract and which are concrete. Concrete classes are 
those that are specific enough to be instantiated. A 
concrete class just means that it’s OK to make objects 
of that type. 

Making a class abstract is easy — put the keyword 
abstract before the class declaration: 



abstract 



class 



Canine extends Animal 



public void roam() { } 



{ 



} 
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interfaces and polymorphism 



The compiler won't let you instantiate 
an abstract class 



An abstract class means that nobody can ever make a new 
instance of that class. You can still use that abstract class as a 
declared reference type, for the purpose of polymorphism, but 
you don’t have to worry about somebody making objects of that 
type. The compiler guarantees it. 



abstract public class Canine extends Animal 

{ 



public void roam() { } 

} 



public class MakeCanine { 
public void go() { 
Canine c; 
c = new Dog() ; 






al»afs a»'y 



^ a svai 



***** 



Cll* 



•Jf the 



c = new Canine ( ) 



c.roam() ; 



File Edit Window Help BeamMeUp 



% javac MakeCanine . j ava 

MakeCanine . j ava : 5 : Canine is abstract; 
cannot be instantiated 
c = new Canine () ; 

A 

1 error 



An abstract class has virtually* no use, no value, no 
purpose in life, unless it is extended . 

With an abstract class, the guys doing the work at runtime 
are instances of a subclass of your abstract class. 



is a* -to -this— dirt abs-trad-t dlass da* 

have s-taiid members (see dhapter 10 ). 

you are here ► 201 



Head First Java, 2nd Edition. Head First Java, 2nd Edition, ISBN: 0596009208 

Prepared for e.simons@icarin.fiuc.org, Eduard Simons 

Copyright © 2005 Bert Bates and Kathy Sierra. This PDF is made available for personal use only during the relevant subscription term, subject to the Safari Terms of Service. Any other use 
requires prior written consent from the copyright owner. Unauthorized use, reproduction and/or distribution are strictly prohibited and violate applicable laws. All rights reserved. 






abstract and concrete classes 



Abstract vs. Concrete 



abstv-adt 



A class that’s not abstract is called 
a concrete class. In the Animal 
inheritance tree, if we make 
Animal, Canine, and Feline 
abstract, that leaves Hippo, Wolf, 
Dog, Tiger, Lion, and Cat as the 
concrete subclasses. 

Flip through the Java API and 
you’ll find a lot of abstract classes, 
especially in the GUI library. What 
does a GUI Component look 
like? The Component class is the 
superclass of GUI-related classes 
for things like buttons, text areas, 
scrollbars, dialog boxes, you name 
it. You don’t make an instance of 
a generic Component and put it on 
the screen, you make a JButton. In 
other words, you instantiate only a 
concrete subclass of Component, but 
never Component itself. 











abstract or concrete? 




How do you know when a class should be 
abstract? I/I fine is probably abstract. But what 
about Red and White ? Again probably abstract 
(for some of us, anyway). But at what point in the 
hierarchy do things become concrete? 

Do you make PinotNoir concrete, or is it abstract 
too? It looks like the Camelot Vineyards 1 997 
Pinot Noir is probably concrete no matter what. 
But how do you know for sure? 

Look at the Animal inheritance tree above. Do the 
choices we've made for which classes are abstract 
and which are concrete seem appropriate? 

Would you change anything about the Animal 
inheritance tree (other than adding more Animals, 
of course)? 
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interfaces and polymorphism 



Abstract methods 



Besides classes, you can mark methods abstract, too. An abstract 
class means the class must be extended ; an abstract method means 
the method must be overridden. You might decide that some (or all) 
behaviors in an abstract class don’t make any sense unless they’re 
implemented by a more specific subclass. In other words, you can’t 
think of any generic method implementation that could possibly be 
useful for subclasses. What would a generic eat() method look like? 

An abstract method has no body! 

Because you’ve already decided there isn’t any code that would make 
sense in the abstract method, you won’t put in a method body. So no 
curly braces — just end the declaration with a semicolon. 



public abstract void eat(); 



M« '° oi r , / 



r 



If you declare an abstract method, you MUST 
mark the class abstract as well. You can’t have 
an abstract method in a non-abstract class. 

If you put even a single abstract method in a class, you have to 
make the class abstract. But you can mix both abstract and non- 
abstract methods in the abstract class. 




^tliereiareno 

Dumb Questions 



VJ- What is the point of an abstract method? I thought 
the whole point of an abstract class was to have common 
code that could be inherited by subclasses. 

Inheritable method implementations (in other words, 
methods with actual bodies) are A Good Thing to put in a 
superclass. When it makes sense. And in an abstract class, it 
often doesn't make sense, because you can't come up with 
any generic code that subclasses would find useful. The 
point of an abstract method is that even though you haven't 
put in any actual method code, you've still defined part of 
the protocol for a group of subtypes (subclasses). 




Which is good because... 



Polymorphism! Remember, what you want is the 
ability to use a superclass type (often abstract) as a method 
argument, return type, or array type.That way, you get to 
add new subtypes (like a new Animal subclass) to your 
program without having to rewrite (or add) new methods 
to deal with those new types. Imagine how you'd have to 
change the Vet class, if it didn't use Animal as its argument 
type for methods. You'd have to have a separate method 
for every single Animal subclass! One that takes a Lion, one 
that takes a Wolf, one that takes a... you get the idea. So with 
an abstract method, you're saying, "All subtypes of this type 
have THIS method." for the benefit of polymorphism. 
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you must implement abstract methods 



You MUST implement all abstract methods 




I have wonderful news, 
mother. Joe finally implemented 
all his abstract methods! Now 
everything is working just the 
( way we planned... - 



Implementing an abstract 
method is just like 
overriding a method. 



Abstract methods don’t have a body; they exist solely for polymorphism. That 
means the first concrete class in the inheritance tree must implement all abstract 
methods. 

You can, however, pass the buck by being abstract yourself. If both Animal and 
Canine are abstract, for example, and both have abstract methods, class Canine 
does not have to implement the abstract methods from Animal. But as soon as we 
get to the first concrete subclass, like Dog, that subclass must implement all of the 
abstract methods from both Animal and Canine. 

But remember that an abstract class can have both abstract and non-abstract 
methods, so Canine, for example, could implement an abstract method from 
Animal, so that Dog didn’t have to. But if Canine says nothing about the abstract 
methods from Animal, Dog has to implement all of Animal’s abstract methods. 

When we say “you must implement the abstract method”, that means you must 
provide a body. That means you must create a non-abstract method in your class 
with the same method signature (name and arguments) and a return type that is 
compatible with the declared return type of the abstract method. What you put in 
that method is up to you. All Java cares about is that the method is there , in your 
concrete subclass. 
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interfaces and polymorphism 




Abstract vs. Concrete Classes 

Let's put all this abstract rhetoric into some concrete use. In the middle 
column we've listed some classes. Your job is to imagine applications 
where the listed class might be concrete, and applications where the listed 
class might be abstract. We took a shot at the first few to get you going. 

For example, class Tree would be abstract in a tree nursery program, where 
differences between an Oak and an Aspen matter. But in a golf simulation 
program, Tree might be a concrete class (perhaps a subclass of Obstacle), 
because the program doesn't care about or distinguish between different 
types of trees. (There's no one right answer; it depends on your design.) 



Concrete 



Sample class Abstract 



golf course simulation 



satellite photo application 



Tree 


tree nursery application 


House 


architect application 


Town 





Football Player coaching application 



Chair 



Customer 



Sales Order 



Book 



Store 



Supplier 
Golf Club 



Carburetor 



Oven 
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polymorphism examples 



Polymorphism m action 

Let’s say that we want to write our own kind of list class, one that will hold 
Dog objects, but pretend for a moment that we don’t know about the 
ArrayList class. For the first pass, we’ll give it just an add() method. We’ll use 
a simple Dog array (Dog []) to keep the added Dog objects, and give it a 
length of 5 . When we reach the limit of 5 Dog objects, you can still call the 
add() method but it won’t do anything. If we’re not at the limit, the add() 
method puts the Dog in the array at the next available index position, then 
increments that next available index (nextlndex) . 



Building our own Dog-specific list 

(Perhaps the world’s worst attempt at making our 
own ArrayList kind of class, from scratch.) 



© 

MyDogList 

Dog[] dogs 
int nextlndex 

add(Dog d) 






public class MyDogList { 

private Dog [] dogs = new Dog [5] ; 

private int nextlndex = 0 ; < VltW mC-v-eroewt tW» s 

•bin* a " eNW ^ ,s added 



public void add (Dog d) { 

if (nextlndex < dogs. length) { 
dogs [nextlndex] = d; k 

System. out .pr in tin ("Dog added at 
nextlndex++ ; ^ 



already at 

ot tv>e doojs avva7, add tV ^ 
a«d 'pvin't a message- 



+ nextlndex) ; 



} 



} 
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interfaces and polymorphism 



Uh-oh, wow we weed to keep Cats, too. 

We have a few options here: 

1) Make a separate class, MyCatList, to hold Cat objects. Pretty clunky. 

2) Make a single class, DogAndCatList, that keeps two different arrays as instance 
variables and has two different add() methods: addCat(Cat c) and addDog(Dog 
d). Another clunky solution. 

3) Make heterogeneous AnimalList class, that takes any kind of Animal subclass 
(since we know that if the spec changed to add Cats, sooner or later we’ll have 
some other kind of animal added as well). We like this option best, so let’s change 
our class to make it more generic, to take Animals instead of just Dogs. We’ve 
highlighted the key changes (the logic is the same, of course, but the type has 
changed from Dog to Animal everywhere in the code. 




MyAnimalList 



Animal[] animals 
int nextlndex 



add(Animal a) 



Building our own Animal-specific list 



public class MyAnimalList { 




private Animal [] animals = new Animal [5] ; 
private int nextlndex = 0 ; 



public void add (Animal a) { 

if (nextlndex < animals . length) { 
animals [nextlndex] = a; 

System . out . println ( "Animal added at 
nextlndex++ ; 



. ,» /,Ve not 3 

't ? av 'f , l. ^eVe a 
• A"’"' 3 tdtt’^ bf? e ^ v "" ,a 



+ nextlndex) ; 



} 



} 



} 



public class AnimalTestDrive{ 

public static void main ( String [] args) { 
MyAnimalList list = new MyAnimalList () ; 
Dog a = new Dog() ; 

Cat c = new Cat() ; 
list. add (a) ; 
list. add (c) ; 

} 

} 



| File Edit Window 


' Help Harm 




1 


% j ava 


Animal TestDrive 


Animal 


added 


at 


0 


Animal 


added 


at 


1 
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the ultimate superclass: Object 



What about wow-Awiwal$? Why wot make 
a class geweric ewough to take anything? 

You know where this is heading. We want to change the 
type of the array, along with the add() method argument, to 
something above Animal. Something even more generic, more 
abstract than Animal. But how can we do it? We don’t have a 
superclass for Animal. 

Then again, maybe we do... 

Remember those methods of ArrayList? 

Look how the remove, contains, and 
indexOf method all use an object of type. 

Object! 






ArrayList 



m , u s-t a 



a ve ">a«y "'°' re 



.) 



int 



Every class in Java extends 
class Object. 

Class Object is the mother of all classes; it’s 
the superclass of everything. 

Even if you take advantage of polymorphism, 
you still have to create a class with methods 
that take and return your polymorphic type. 

Without a common superclass for everything 
in Java, there ’d be no way for the developers 
of Java to create classes with methods that 
could take your custom types... types they never 
knew about when they wrote the ArrayList class. 

So you were making subclasses of class Object 
from the very beginning and you didn’t even 1 \\ nflOire 

know it. Every class you write extends Object , 
without your ever having to say it. But you can 
think of it as though a class you write looks like 
this: 

public class Dog extends Object { } 

But wait a minute, Dog already extends something, Canine. 
That’s OK. The compiler will make Canine extend Object 
instead. Except Canine extends Animal. No problem, then the 
compiler will just make Animal extend Object. 

Any class that doesn’t explicitly extend another 
class, implicitly extends Object. 

So, since Dog extends Canine, it doesn’t directly extend Object 
(although it does extend it indirectly), and the same is true 
for Canine, but Animal does directly extend Object. 



bo ole,° removetObjert parameter Re'ufns 

boolean me 

Returns 'true if there s 



or-1. 



to C 4-Vie AvrayL-'st methods use the 
y , n 2, W, Obvett ante 

atWIy °° ^ b* tte 

than the ones s own > . 

1S the wa 7 to tw.nk about -t. we 5 

the tull stov'f a little 
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interfaces and polymorphism 



So what's in this ultra-super-megaclass Object? 



If you were Java, what behavior would you want every 
object to have? Hmmmm... let’s see... how about a 
method that lets you find out if one object is equal 
to another object? What about a method that can 
tell you the actual class type of that object? Maybe a 
method that gives you a hashcode for the object, so 
you can use the object in hash tables (we’ll talk about 
Java’s hashtables in chapter 17 and appendix B). 

Oh, here’s a good one — a method that prints out a 
String message for that object. 

And what do you know? As if by magic, class Object 
does indeed have methods for those four things. 
That’s not all, though, but these are the ones we 
really care about. 




0«l SCM6 J 

of class Object 



Evevy class you wv-itt inherits all -the 
methods of class Object The classes 
youve witte* inherited methods you 
didn't eve* k*ow you had. 



(?) equals(Object o) 

Dog a = new Dog() ; 
Cat c = new Cat ( ) ; 



(3) hashCode() 

Cat c = new Cat() ; 

Sy s tem . out . pr intln ( c . hashCode ( ) ) ; 



if (a . equals (c) ) { 

System. out .pr in tin ("true") ; 

} else { 

System. out .pr in tin ("false") ; 

} 

Tells vou if two objects are 
Considered 'e<\*>l’ ' ta,k 

about what 'e<\*al' really 
means in ayyendi* 



% java TestObject 
false 



File Edit Window Help Drop 



% java TestObject 
8202111 



@ toString() 

Cat c = new Cat ( ) ; 

System. out. pr intln (c. toString() ) ; 



(2) getClass() 

Cat c = new Cat ( ) ; 

System. out. println(c.getClass () ) ; 

dlass that object was 
instantiated W- 



java TestObject 
lass Cat 



File Edit Window Help LapselntoComa 



% java TestObject 
Cat@7d277f 



q . . . a Sttinoy message 

pv.ntt o« , , , t | ass 
with the na»»>e of the 
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Object and abstract classes 



fjiereictrerip 

Dumb Questions 




Is class Object abstract? 



No. Well, not in the formal 
Java sense anyway. Object is a 
non-abstract class because it's 
got method implementation 
code that all classes can inherit 
and use out-of-the-box, without 
having to override the methods. 




Then can you override 



the methods in Object? 



Some of them. But some of 
them are marked final, which 
means you can't override them. 
You're encouraged (strongly) to 
override hashCodeO, equalsO, 
and toStringO in your own 
classes, and you'll learn how to 
do that a little later in the book. 
But some of the methods, like 
getClassO, do things that must 
work in a specific, guaranteed 
way. 



If ArrayList methods are 
generic enough to use Object, 
then what does it mean to say 
ArrayList<DotCom>? I thought 
I was restricting the ArrayList to 
hold only DotCom objects? 

You were restricting it. 

Prior to Java 5.0, ArrayLists 
couldn't be restricted. They 
were all essentially what you 
get in Java 5.0 today if you write 
ArrayList<Object>. In other 
words, an ArrayList restricted 
to anything that's an Object, 
which means any object in Java, 
instantiated from any class type! 
We'll cover the details of this new 
<type> syntax later in the book. 



VJ OK, back to class Object 
being non-abstract (so I guess 
that means it's concrete), HOW 
can you let somebody make an 
Object object? Isn't that just 
as weird as making an Animal 
object? 

Good question! Why is 
it acceptable to make a new 
Object instance? Because 
sometimes you just want a 
generic object to use as, well, as 
an object. A lightweight object. 

By far, the most common use of 
an instance of type Object is for 
thread synchronization (which 
you'll learn about in chapter 15). 
For now, just stick that on the 
back burner and assume that 
you will rarely make objects of 
type Object, even though you 
can. 

% So is it fair to say that the 
main purpose for type Object 
is so that you can use it for a 
polymorphic argument and 
return type? Like in ArrayList? 

The Object class serves 
two main purposes: to act as a 
polymorphic type for methods 
that need to work on any class 
that you or anyone else makes, 
and to provide real method code 
that all objects in Java need at 
runtime (and putting them in 
class Object means all other 
classes inherit them). Some of 
the most important methods in 
Object are related to threads, 
and we'll see those later in the 
book. 



If it's so good to use 
polymorphic types, why 
don't you just make ALL your 
methods take and return type 
Object? 

Ahhhh... think about what 
would happen. For one thing, 
you would defeat the whole 
point of 'type-safety', one 
of Java's greatest protection 
mechanisms for your code. With 
type-safety, Java guarantees that 
you won't ask the wrong object 
to do something you meant to 
ask of another object type. Like, 
ask a Ferrari (which you think is a 
Toaster ) to cook itself. 

But the truth is, you don't have 
to worry about that fiery Ferrari 
scenario, even if you do use 
Object references for everything. 
Because when objects are 
referred to by an Object 
reference type, Java thinks it's 
referring to an instance of type 
Object. And that means the 
only methods you're allowed to 
call on that object are the ones 
declared in class Object! So if 
you were to say: 

Object o = new Ferrari () ; 
o.goFast() ; //Not legal! 

You wouldn't even make it past 
the compiler. 

Because Java is a strongly-typed 
language, the compiler checks 
to make sure that you're calling 
a method on an object that's 
actually capable of responding. 

In other words, you can call a 
method on an object reference 
only if the class of the reference 
type actually has the method. 
We'll cover this in much greater 
detail a little later, so don't worry 
if the picture isn't crystal clear. 
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interfaces and polymorphism 



Using polymorphic references of type Object has a price... 



Before you run off and start using type Object for all your ultra-flexible argument and return 
types, you need to consider a little issue of using type Object as a reference. And keep in mind 
that we’re not talking about making instances of type Object; we’re talking about making 
instances of some other type, but using a reference of type Object. 

When you put an object into an ArrayList<Dog>, it goes in as a Dog, and comes out as a Dog: 

Make a« /WayUs-t detlaned 

ArrayList<Dog> myDogArrayList = new ArrayList<Dog> ( ) ; f© hold P 05 objefc-b- 
Dog aDog = new Dog ( ) ; ^ — "Make a P° 5 ‘ 

myDogArrayList . add (aDog) ; £ — Add ^ r i» y l i 0 a Po<\ er&stt variable- 

A»g* the P°g W 1,st * a a p o „ rt U 

Dog d = myDogArrayList . get ( 0 ) ; (Think 0$ i-t as though the ^e-to we-tw 

type bedause you used A^ayL-isW^ -> 

But what happens when you declare it as ArrayList<Object>? If you want to make an ArrayList 
that will literally take any kind of Object, you declare it like this: 



ArrayList<Ob ject> myDogArrayList = new ArrayList<Ob ject> 

Dog aDog = new Dog ( ) ; Make a Dog- L, (Th ^ ^ ^ a> . e ^ ) 

. .. i-n 1 1L- X f 

myDogArrayList . add (aDog) ; 



^ Make an A^ayUst dedlawd 
; K -to hold any type 0+ Objedt- 



-Add the Dog to Ike list 



But what happens when you try to get the Dog object and assign it to a Dog reference? 

Dog d = myDogArrayList. get (0) ; W -- tom P lle ” wt> en you use A*-*-ayList<0bjedt>, the getO method 

returns type Objedt- The Compiler knows only that the objedt inherits -Prom 
Objedt (somewhere in its inheritande tree) but it doesn’t know it’s a Dog// 

Everything comes out of an ArrayList<Object> as a reference of type Object, regardless of what the 
actual object is, or what the reference type was when you added the object to the list. 



The objects go IN 
as SoccerBall, 
Fish, Guitar, and 
Car. 




ArrayList<Object> 



But they come 
OUT as though 
they were of type 

Object. 



I I I 1 



Objects come out of 
an ArrayList<Object> 
acting like they’re 
generic instances 
of class Object. The 
Compiler cannot 
assume the object 
that comes out is of 
any type other than 
Object. 
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When a Dog loses its Dogness 



When a Pog wont act like a Pog 

The problem with having everything treated 
polymorphically as an Object is that the objects 
appear to lose (but not permanently) their 
true essence. The Dog appears to lose its dogness. 
Let’s see what happens when we pass a Dog to 
a method that returns a reference to the same 
Dog object, but declares the return type as type 
Object rather than Dog. 



public void go() { 

Dog aDog = new Dog() ; 

Dog sameDog = getOb ject (aDog) ; 







public Object getObject (Object o) { 

return o; C evente -to the sa««e P°3> as a 

} ^ We « a tete ^ ^ ^ ^ 

reW« type J J) „ e thod works when yow have 

is si "' i,av : t an AtnavUst<Po a >. 



File Edit Window Help Remember 



DogPolyTest . java : 10 : incompatible types 
found : j ava . lang . Ob j ect 
required: Dog 

Dog sameDog = takeObjects (aDog) ; 
1 error A 



The domyiler doesn't know that the 
thing returned 'from the method is 
y adtually a Pog, so it wont let you 
assign it to a Pog re-ferende. (You’ll 
see why on the next page.) 



6f00V 

© 



public void go() { 

Dog aDog = new Dog() ; 

Object sameDog = getObject (aDog) ; 



public Object getObject (Ob ject o) { 
return o; 

} 
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This works (although it may not be very 
use-ful, as you ; || see in a moment) bedause you 
dan assign A NYTR||N/£j to a re-ferende of tyye 
0bjedt, sinde every dlass yasses the |S-A test 
-for Objedt- Every objedt in Java is an instande 
of type Objedt, bedause every dlass in Java has 
Objedt at the toy of its inheritande tree- 
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interfaces and polymorphism 



Objects don't bark. 

So now we know that when an object is 
referenced by a variable declared as type 
Object, it can’t be assigned to a variable 
declared with the actual object’s type. 
And we know that this can happen when 
a return type or argument is declared 
as type Object, as would be the case, 
for example, when the object is put 
into an ArrayList of type Object using 
ArrayList<Object>. But what are the 
implications of this? Is it a problem to 
have to use an Object reference variable 
to refer to a Dog object? Let’s try to call 
Dog methods on our Dog-That-Compiler- 
Thinks-Is-An-Obj ect: 




d °9 dofP 



When you get an objedt eirende -Pv-om 
an A^yList<Objedt> (ov- any method 
that dedlares Objedt as the vetuvn type), 
it domes badk as a polymov-phid v-e-f evende ' 
type <y P Objedt- So you have an Objedt 
v*e£e|rende to (in this dase) a Dog instande- 



Won t 



tie! 



Object o = al . get (index) ; 
int i = o . hashCode ( ) ; 
o . bark ( ) ; * 



• fme-Qa* 












or> 1 



Can’t do -this// TKe Object dlass has no idea wbat 
it means to bav-kO. Even tbougb yOU know it’s 
v-eally a Dog at that index-, tbe dompilev doesn’t-. 



The compiler decides whether 
you can call a method based 
on the reference type, not the 
actual object type. 



Even if you know the object is capable 
(“...but it really is a Dog, honest...”), the 
compiler sees it only as a generic Object. 
For all the compiler knows, you put a 
Button object out there. Or a Microwave 
object. Or some other thing that really 
doesn’t know how to bark. 

The compiler checks the class of the 
reference type — not the object type — to 
see if you can call a method using that 
reference. 




The method youVe dalling on a 
re-fevende MUST be in the dlass o( 
that re-ferende type- Does* t matter 
what the adtual objedt is. 



Object 



ygo bF 



Object 

equals() 
getClass() 
hashCode() ^ 
toStringQ ^ 



The w o w re-ferende was dedlared as type 
Objedt, so you dan dal I methods only if 
those methods are in dlass Objedt-. 
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objects are Objects 




fret in touch with your inner Object. 

An object contains everything it inherits from each of its 
superclasses. That means every object — regardless of its 
actual class type — is also an instance of class Object.That 
means any object in Java can be treated not just as a Dog, 
Button, or Snowboard, but also as an Object. When you 
say new Snowboard ( ) , you get a single object on the 
heap — a Snowboard object — but that Snowboard wraps 
itself around an inner core representing the Object 
(capital “O”) portion of itself. 




There is only ONE objedt on the heap here- A Snowboard 
objedt But it d oh tarns both the Snowboard dlass parts o( 
itsel'f and the ^ Objedt dlass parts o( itsel-P- 
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interfaces and polymorphism 



‘Polymorphism’ means 
‘many forms’. 

You can treat a Snowboard as a 
Snowboard or as an Object. 

If a reference is like a remote control, the 
remote control takes on more and more buttons 
as you move down the inheritance tree. A 
remote control (reference) of type Object has 
only a few buttons — the buttons for the exposed 
methods of class Object. But a remote control 
of type Snowboard includes all the buttons from 
class Object, plus any new buttons (for new 
methods) of class Snowboard. The more specific 
the class, the more buttons it may have. 

Of course that’s not always true; a subclass might 
not add any new methods, but simply override 
the methods of its superclass. The key point is 
that even if the object is of type Snowboard, an 
Object reference to the Snowboard object can’t see 
the Snowboard-specific methods. 



Snowboard 
Object O = 



When you put 
an object in an 
ArrayList<Object>, you 
can treat it only as an 
Object, regardless of 
the type it was when 
you put it in. 

When you get a 
reference from an 
ArrayList<Object>, the 
reference is always of 
type Object 

That means you get an 
Object remote control. 




The Snowboard remote don't 
(re-Perende) has more buttons than 
an Objedt remote dontrol- The 
Snowboard remote dan see the -Pull 
Snowboardness o-P the Snowboard 
objedt It dan addess all the methods 
in Snowboard, indluding both the 
inherited Objedt methods and the 
methods -Prom dlass Snowboard- 






The Objedt re-Perende dan se e only the 
Objedt parts o-P the Snowboard objedt- 
It dan addess only the methods o-P dlass 
Objedt- It has -Pewer buttons than the 
Snowboard remote dontrol- 
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casting objects 




,r, 

Cas-t "the so— dolled Objed'i (buf, 
we khow be's actually a Dog) -to 
type Dog, so that you da* treat 
bim like tbe Dog be really is. 



Wait a minute... what good 
^ is a Dog if it comes out of an 
ArrayList<Object> and it can't do 
any Dog things? There's gotta be a 
way to get the Dog back to a state 
of Dogness... 



I hope it doesn't hurt. 
And what's so wrong with 
staying an Object? OK, I can't 
fetch, sure, but I can give you 
a real nice hashcode. 



Casting an object reference 
back to its real type. 




It’s really still a Dog object, but if you want to call 
Dog-specific methods, you need a reference declared 
as type Dog. If you’re sure * the object is really a 
Dog, you can make a new Dog reference to it by 
copying the Object reference, and forcing that 
copy to go into a Dog reference variable, using a 
cast (Dog) . You can use the new Dog reference to 
call Dog methods. 




=t o = al. get (index) ; . V** to 

H = fnrw-D r> • . dasb vhd J J.v«ve. 



*If you’re not sure it’s a Dog, you can use the 
instanceof operator to check. Because if 
you’re wrong when you do the cast, you’ll get a 
ClassCastException at runtime and come to a 
grinding halt. 



if (o instanceof Dog) { 
Dog d = (Dog) o; 

} 
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interfaces and polymorphism 



So now you’ve seen how much Java 
cares about the methods in the 
class of the reference variable. 

You can call a method on an object only if 
the class of the reference variable has that 
method. 




Think of the public methods in your class as 
your contract, your promise to the outside 
world about the things you can do. 



When you write a class, you almost always expose some 
of the methods to code outside the class. To expose a 
method means you make a method accessible, usually by 
marking it public. 

Imagine this scenario: you’re writing code for a small 
business accounting program. A custom application 
for “Simon’s Surf Shop”. The good re- 
user that you are, you found an Account 
class that appears to meet your needs 
perfectly, according to its documentation, 
anyway. Each account instance represents 
an individual customer’s account with the 
store. So there you are minding your own 
business invoking the credit() and debit() 
methods on an account object when you realize you 
need to get a balance on an account. No problem — 
there’s a getBalance() method that should do nicely. 

Except... when you invoke the getBalance() method, 
the whole thing blows up at runtime. Forget the 
documentation, the class does not have that method. 
Yikes! 

But that won’t happen to you, because everytime you 
use the dot operator on a reference (a.doStuffQ), the 
compiler looks at the reference type (the type ‘a’ was 
declared to be) and checks that class to guarantee the 
class has the method, and that the method does indeed 
take the argument you’re passing and return the kind of 
value you’re expecting to get back. 

Just remember that the compiler checks the class of the 
reference variable, not the class of the actual object at the 
other end of the reference. 



Account 

debit(double amt) 
credit(double amt) 
double getBalanceQ 
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modifying a class tree 



What if you weed to change 
the contract? 



OK, pretend you’re a Dog. Your Dog class 
isn’t the only contract that defines who you 
are. Remember, you inherit accessible (which 
usually means public) methods from all of 
your superclasses. 

True, your Dog class defines a contract. 

But not all of your contract. 

Everything in class Canine is part of your 
contract. 

Everything in class Animal is part of your 
contract. 

Everything in class Object is part of your 
contract. 

According to the IS-A test, you are each of 
those things — Canine, Animal, and Object. 

But what if the person who designed your 
class had in mind the Animal simulation 
program, and now he wants to use you (class 
Dog) for a Science Fair Tutorial on Animal 
objects. 

That’s OK, you’re probably reusable for that. 

But what if later he wants to use you for a 
PetShop program? You don ’t have any Pet 
behaviors. A Pet needs methods like beFriendly() 
and play(). 

OK, now pretend you’re the Dog class 
programmer. No problem, right? Just add 
some more methods to the Dog class. You 
won’t be breaking anyone else’s code by 
adding methods, since you aren’t touching 
the existing methods that someone else’s code 
might be calling on Dog objects. 

Can you see any drawbacks to that approach 
(adding Pet methods to the Dog class)? 







Think about what YOU would do if YOU were 
the Dog class programmer and needed to 
modify the Dog so that it could do Pet things, 
too. We know that simply adding new Pet be- 
haviors (methods) to the Dog class will work, 
and won't break anyone else's code. 

But... this is a PetShop program. It has more 
than just Dogs! And what if someone wants 
to use your Dog class for a program that has 
wild Dogs? What do you think your options 
might be, and without worrying about how 
Java handles things, just try to imagine how 
you'd like to solve the problem of modifying 
some of your Animal classes to include Pet 
behaviors. 

Stop right now and think about it, 
before you look at the next page where we 
begin to reveal everything. 

(thus rendering the whole exercise completely useless, robbing 
you of your One Big Chance to burn some brain calories) 
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interfaces and polymorphism 



let's explore some design options 
for reusing some of our existing 
classes in a PetSbop program. 

On the next few pages, we’re going to walk through 
some possibilities. We’re not yet worried about 
whether Java can actually do what we come up with. 
We’ll cross that bridge once we have a good idea of 
some of the tradeoffs. 



0 Option one 

We take the easy path, and put pet 
methods in class Animal. 

Pros: 

All the Animals will instantly inherit 
the pet behaviors. We won't have to 
touch the existing Animal subclasses 
at all, and any Animal subclasses 
created in the future will also get to 
take advantage of inheriting those 
methods. That way, class Animal can 
be used as the polymorphic type in 
any program that wants to treat the 
Animals as pets 

Cons: 

So... when was the last time you 
saw a Hippo at a pet shop? Lion? 

Wolf? Could be dangerous to give 
non-pets pet methods. 



Also, we almost certainly WILL 
have to touch the pet classes 
like Dog and Cat, because (in 
our house, anyway) Dogs 
and Cats tend to imple- 
ment pet behaviors 
VERY differently. 



L j\\ Y ye*-*- 

r \L<u° Ac ^ 
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modifying existing classes 



© Option two 

We start with Option One, putting the pet methods 
in class Animal, but we make the methods abstract, 
forcing the Animal subclasses to override them. 

Pros: 

That would give us all the benefits of Option One, but with- 
out the drawback of having non-pet Animals running around 
with pet methods (like beFriendlyO). All Animal classes 
would have the method (because it's in class Animal), but 
because it's abstract the non-pet Animal classes won't 
inherit any functionality. All classes MUST override the 
methods, but they can make the methods "do-nothings". 






/ 






Cons: 

Because the pet methods in the Animal class are all 
abstract, the concrete Animal subclasses are forced to 
implement all of them. (Remember, all abstract methods 
MUST be implemented by the first concrete subclass 
down the inheritance tree.) What a waste of time! 

You have to sit there and type in each and every 
pet method into each and every concrete non- 
pet class, and all future subclasses as well. 

And while this does solve the problem of 
non-pets actually DOING pet things 
(as they would if they inherited pet 
functionality from class Animal), the 
contract is bad. Every non - pet 
class would be announcing to the 
world that it, too, has those 
pet methods, even though 
the methods wouldn't 
actually DO anything 
when called. 

This approach doesn't 
look good at all. It just 
seems wrong to stuff 
everything into class Animal 
that more than one Animal type 
might need, UNLESS it applies to 
ALL Animal subclasses. 



| Animal ~| 
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interfaces and polymorphism 



® Option three 

Put the pet methods ONLY in the 
classes where they belong. 

Pros: 

No more worries about Hippos greeting you at the 
door or licking your face. The methods are where 
they belong, and ONLY where they belong. Dogs can 
implement the methods and Cats can implement the 
methods, but nobody else has to know about them. 

Cons: 

Two Big Problems with this approach. First off, you'd 
have to agree to a protocol, and all programmers of 
pet Animal classes now and in the future would have 
to KNOW about the protocol. By protocol, we mean 
the exact methods that we've decided all pets should 
have. The pet contract without anything to back it up. 
But what if one of the programmers gets it just a tiny 
bit wrong? Like, a method takes a String when it was 
supposed to take an int? Or they named it doFriendlyO 
instead of beFriendlyO? Since it isn't in a contract, 
the compiler has no way to check you to see if you've 
implemented the methods correctly. Someone 
could easily come along to use the pet Animal 
classes and find that not all of them work 
quite right. 



And second, you don't get to use 
polymorphism for the pet methods 
Every class that needs to use 
pet behaviors would have to 
know about each and every 
class! In other words, 
you can't use Animal 
as the polymorphic 
type now, because the 
compiler won't let you call 
a Pet method on an Animal 
reference (even if it's really a 
Dog object) because class Animal 
doesn't have the method. 



— 



Animal | 
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multiple inheritance? 



So what we REALLY need is: 

♦ A way to have pet behavior in just the pet classes 

♦ A way to guarantee that all pet classes have all of the same 
methods defined (same name, same arguments, same return 
types, no missing methods, etc.), without having to cross your 
fingers and hope all the programmers get it right. 

♦ A way to take advantage of polymorphism so that all pets can have 
their pet methods called, without having to use arguments, return 
types, and arrays for each and every pet class. 



It looks like we need TWO 
superclasses at the top 






i / 

■ vif. vk 



Anil 


nal 








Hifrso L 










The non— 

don t have any inhevi-ted 

Pet stuff. 
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interfaces and polymorphism 



There's just one problem with the "two superclasses" approach... 

It’s called “multiple inheritance” 
and it can be a Really Bad Thing. 

That is, if it were possible to do in Java. 

But it isn't, because multiple inheritance has a problem 
known as The Deadly Diamond of Death. 



Deadly Diamond of Death 




A language that allows the Deadly Diamond of Death can lead to 
some ugly complexities, because you have to have special rules to 
deal with the potential ambiguities. And extra rules means extra 
work for you both in learning those rules and watching out for 
those “special cases”. Java is supposed to be simple, with consistent 
rules that don’t blow up under some scenarios. So Java (unlike 
C++) protects you from having to think about the Deadly Dia- 
mond of Death. But that brings us back to the original problem! 
How do we handle the Animal/ Pet thing ? 
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interfaces 



Interface to the rescue! 

Java gives you a solution. An interface. Not a GUI interface, not the generic 
use of the word interface as in, “That’s the public interface for the Button 
class API,” but the Java keyword interface. 

A Java interface solves your multiple inheritance problem by giving you 
much of the polymorphic benefits of multiple inheritance without the pain 
and suffering from the Deadly Diamond of Death (DDD). 

The way in which interfaces side-step the DDD is surprisingly simple: make 
all the methods abstract! That way, the subclass must implement the methods 
(remember, abstract methods must be implemented by the first concrete 
subclass), so at runtime the JVM isn’t confused about which of the two 
inherited versions it’s supposed to call. 



Pet 



abstract void beFriendlyO; 
abstract void playQ; 



A Java interface is like a 
100% pure abstract class. 






To DEFINE an interface: 

public interface Pet { . . . } 




To IMPLEMENT an interface: 



public class Dog extends Canine implements Pet (...) 

u .A./ JfoUo^cd 

“I, 

t, a, tatortw 1 °“ 

M 3 
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interfaces and polymorphism 



Making and Implementing 
the Pet interface 



V— 

o? 't\ass V^e 



\ 

public interface Pet { 



s7tt, rctf - ^ ^ ^ 

,s optional fi„ U' P b ! £ and 
*fy'’ io hy e j Mi ***** 'nood 

w- dM, *, 4 ; j. 5 1 ^ 



public abstract void beFriendlyO 
public abstract void play() ; 



«oWy. 







public class Dog extends Canine implements Pet { 



Vow sav Vple"'^' 
- - <£ “the mt«^ afcc * 



public void beFriendlyO { . . . } 
public void play() {..} 






public void roam() { . . . } 
public void eat() { . . . } 



Vou g/\iD 

'•"p/emen^ {^ e p | * ^ J° Y°>* tylAST 
?*hrati. Mo l ic , ±C , ds - ft * w 






T »>« e a»r e jwt hohKa , 
ovennding methods. 
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Dumb Questions 

% Wait a minute, interfaces don't 
really give you multiple inheritance, 
because you can't put any 
implementation code in them. If all 
the methods are abstract, what does 
an interface really buy you? 

Polymorphism, polymorphism, 
polymorphism. Interfaces are the 
ultimate in flexibility, because if you 
use interfaces instead of concrete 
subclasses (or even abstract superclass 
types) as arguments and return 



types, you can pass anything that 
implements that interface. And think 
about it — with an interfaces class 
doesn't have to come from just one 
inheritance tree. A class can extend 
one class, and implement an interface. 
But another class might implement 
the same interface, yet come from a 
completely different inheritance tree! 
So you get to treat an object by the 
role it plays, rather than by the class 
type from which it was instantiated. 

In fact, if you wrote your code to use 
interfaces, you wouldn't even have to 
give anyone a superclass that they had 



to extend. You could just give them 
the interface and say,"Here,' I don't 
care what kind of class inheritance 
structure you come from, just 
implement this interface and you'll be 
good to go." 

The fact that you can't put in 
implementation code turns out not to 
be a problem for most good designs, 
because most interface methods 
wouldn't make sense if implemented 
in a generic way. In other words, most 
interface methods would need to 
be overridden even if the methods 
weren't forced to be abstract. 
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interface polymorphism 



Classes from different inheritance trees 
can implement the same interface. 




Class RobcDofj doesn't 

rb" ihe 




i 



When you use a class as a polymorphic type (like an 
array of type Animal or a method that takes a Canine 
argument), the objects you can stick in that type 
must be from the same inheritance tree. But not just 
anywhere in the inheritance tree; the objects must be 
from a class that is a subclass of the polymorphic type. 
An argument of type Canine can accept a Wolf and a 
Dog, but not a Cat or a Hippo. 

But when you use an interface as a polymorphic 
type (like an array of Pets), the objects can be 
from anywhere in the inheritance tree. The only 
requirement is that the objects are from a class that 
implements the interface. Allowing classes in different 
inheritance trees to implement a common interface 
is crucial in the Java API. Do you want an object 
to be able to save its state to a hie? Implement the 
Serializable interface. Do you need objects to run 
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their methods in a separate thread of execution? 
Implement Runnable. You get the idea. You’ll 
learn more about Serializable and Runnable in later 
chapters, but for now, remember that classes from 
any place in the inheritance tree might need to 
implement those interfaces. Nearly any class might 
want to be saveable or runnable. 

Better still, a class can implement 
multiple interfaces! 

A Dog object IS-A Canine, and IS-A Animal, and 
IS-A Object, all through inheritance. But a Dog IS-A 
Pet through interface implementation, and the Dog 
might implement other interfaces as well. You could 
say: 

public class Dog extends Animal implements 
Pet, Saveable, Paintable { ... } 
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interfaces and polymorphism 




How do you know whether to make a 
class, a subclass, an abstract class, or 
an interface? 

^ Make a class that doesn't extend anything 

(other than Object) when your new class doesn't 
pass the IS -A test for any other type. 

^ Make a subclass (in other words, extend a class) 
only when you need to make a more specific 
version of a class and need to override or add 
new behaviors. 

^ Use an abstract class when you want to define 
a template for a group of subclasses, and you 
have at least some implementation code that all 
subclasses could use. Make the class abstract 
when you want to guarantee that nobody can 
make objects of that type. 

^ Use an interface when you want to define a role 
that other classes can play, regardless of where 
those classes are in the inheritance tree. 
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using super 



Invoking the superclass 
version of a method 

% What if you make a concrete subclass 
and you need to override a method, but you 
want the behavior in the superclass version of 
the method? In other words, what if you don't 
need to replace the method with an override, 
but you just want to add to it with some 
additional specific code. 

Ahhh... think about the meaning of the 
word 'extends' One area of good 00 design looks 
at how to design concrete code that's meant to 
be overridden. In other words, you write method 
code in, say, an abstract class, that does work 
that's generic enough to support typical concrete 
implementations. But, the concrete code isn't 
enough to handle all of the subclass-specific 
work. So the subclass overrides the method 
and extends it by adding the rest of the code. 

The keyword super lets you invoke a superclass 
version of an overridden method, from within the 
subclass. 

\( method Lode inside a 
Buzz.woirdRepo\rt subdlass says: 

super . runReport ( ) ; 

the \runRepo\rtO method inside 
the superdlass Report will run 



super.runReport(); 

A re-Perende to the subdlass objedt 
(Buzz-wordReport) will always dall 
the subdlass version ©f an overridden 
method- That's polymorphism. 

But the subdlass dode dan dall 
super- runReportO to invoke the 
superdlass version- 



super 



the r 



abstract class Report { 
void runReport ( ) { 

// set-up report 

} 



«/ 



tJhat 



void printReport ( ) { 

// generic printing 



class Buzz words Report extends Report { 



void runReport ( ) { 

super . runReport ( ) 
buzzwordCompliance ( ) ; 
printReport ( ) ; 



} 






void buzzwordCompliance () { . . . } 




superclass 

,tWdmO| the overbidden 

*>l Re\>ovtO 



The super keyword is really a reference 
to -the superclass portion o-f an object 
l/Vhen subdlass dode uses super, as in 
super-runReportO, the superdlass version o( 
the method will run- 
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interfaces and polymorphism 



BULLET POINTS 

y When you don’t want a class to be instantiated (in other words, you don’t 
want anyone to make a new object of that class type) mark the class with the 
abstract keyword. 

y An abstract class can have both abstract and non-abstract methods. 

y If a class has even one abstract method, the class must be marked abstract. 

y An abstract method has no body, and the declaration ends with a semicolon (no 
curly braces). 

y All abstract methods must be implemented in the first concrete subclass in the 
inheritance tree. 

^ Every class in Java is either a direct or indirect subclass of class Object (java.lang. 
Object). 

y Methods can be declared with Object arguments and/or return types. 

y You can call methods on an object only if the methods are in the class (or interface) 
used as the reference variable type, regardless of the actual object type. So, a 
reference variable of type Object can be used only to call methods defined in class 
Object, regardless of the type of the object to which the reference refers. 

y A reference variable of type Object can’t be assigned to any other reference type 
without a cast. A cast can be used to assign a reference variable of one type to a 
reference variable of a subtype, but at runtime the cast will fail if the object on the 
heap is NOT of a type compatible with the cast. 

Example: Dog d = (Dog) x. getObject (aDog) ; 

y All objects come out of an ArrayList<Object> as type Object (meaning, they can be 
referenced only by an Object reference variable, unless you use a cast). 

y Multiple inheritance is not allowed in Java, because of the problems associated with 
the “Deadly Diamond of Death”. That means you can extend only one class (i.e. you 
can have only one immediate superclass). 

y An interface is like a 100% pure abstract class. It defines only abstract methods. 

y Create an interface using the interface keyword instead of the word class. 

y Implement an interface using the keyword implements 
Example: Dog implements Pet 

y Your class can implement multiple interfaces. 

y A class that implements an interface must implement all the methods of the 
interface, since all interface methods are implicitly public and abstract. 

y To invoke the superclass version of a method from a subclass that’s overridden the 
method, use the super keyword. Example: super .runReporto ; 



There's still something 
strange here... you never 
explained how it is that 
ArrayList<Dog> gives back Dog 
references that don't need to be 
cast, yet the ArrayList class uses 
Object in its methods, not Dog 
(or DotCom or anything else). 
What's the special trick going on 
when you say ArrayList<Dog>? 

You're right for calling it a 
special trick. In fact it is a special 
trick that ArrayList<Dog> gives 
back Dogs without you having 
to do any cast, since it looks like 
ArrayList methods don't know 
anything about Dogs, or any type 
besides Object. 

The short answer is that the 
compiler puts in the cast for you! 
When you say ArrayList<Dog>, 
there is no special class that has 
methods to take and return Dog 
objects, but instead the <Dog> 
is a signal to the compiler that 
you want the compiler to let 
you put ONLY Dog objects in 
and to stop you if you try to add 
any other type to the list. And 
since the compiler stops you 
from adding anything but Dogs 
to the ArrayList, the compiler 
also knows that its safe to cast 
anything that comes out of that 
ArrayList do a Dog reference. In 
other words, using ArrayList<Dog> 
saves you from having to cast 
the Dog you get back. But it's 
much more important than that... 
because remember, a cast can 
fail at runtime, and wouldn't you 
rather have your errors happen 
at compile time rather than, say, 
when your customer is using it for 
something critical? 

But there's a lot more to this story, 
and we'll get into all the details in 
the Collections chapter. 
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exercise: What’s the Picture? 




Here's your chance to demonstrate your artistic abilities. On the left you'll 
find sets of class and interface declarations. Your job is to draw the associated 
class diagrams on the right. We did the first one for you. Use a dashed line for 
"implements" and a solid line for "extends" 



(riven: 

1) public interface Foo { } 
public class Bar implements Foo { } 

2) public interface Vinn { } 
public abstract class Vout implements Vinn { } 



Wbatfc the Picture ? 



1) 



fuvtev-Pade) 



2 ) 






Bav 



public abstract class Muffie implements Whuffie { } 
public class Fluffie extends Muffie { } 
public interface Whuffie { } 



3 ) 



public class Zoop { } 

public class Boop extends Zoop { } 

public class Goop extends Boop { } 



4 ) 



J) public class Gamma extends Delta implements Epsilon { } 
public interface Epsilon { } 
public interface Beta { } 

public class Alpha extends Gamma implements Beta { } 
public class Delta { } 



5 ) 
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puzzle: Pool Puzzle 




p«i \ 

Puz/Jc - 




Your job is to take code snippets from the pool and 
place them into the blank lines in the code and out- 
put. You may use the same snippet more than once, 
and you won't need to use all the snippets. Your 
goal is to make a set of classes that will compile 
and run and produce the output listed. 



Nose { 



abstract class Picasso implements 



return 7 ; 



class 



class 



return 5; 



{ } 



public 



extends Clowns { 



public static void main (String [] args ) { 



i [ 0 ] = new 
i [ 1 ] = new 
i [ 2 ] = new 



for(int x = 0; x < 3; x++) { 

System. out . println ( 

+ " " + _ 

} 



.getClass( ) 



Output ^Fil^Edi^Windo^Hel^BeAfrai^ 



5 class Acts 
7 class Clowns 



Note: Each snippet 
from the pool can be 
used more than once! 
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interfaces and polymorphism 




Excise Solutions 



Whatfc the Picture ? 





Whatfc the declaration ? 



2 ) 

3 ) 

4 ) 



public abstract class Top { } 
public class Tip expends Top { } 

public abstract class Fee { } 

public abstract class Fi expends Fee { } 

public interface Foo { } 

public class Bar implements Foo { } 

public class Baz. extends Bar { } 



public interface ^eta f } 

public class Alpha implements 7.eta { } 

public inter-face Beta { } 

public class Delta extends Alpha implements Beta { } 
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puzzle solution 




interface Nose { 

public int iMe+hod( ) ; 

> 

abstract class Picasso implements Nose { 
public int iMethod( ) { 

return 7 ; 

> 

> 

class Clowns extends Picasso { } 

class Acts extends Picasso { 
public int iMethod( ) { 

return 5 ; 

> 

> 



public class Of76 extends Clowns { 

public static void main (String [] args ) { 

Nose [ ] i = new Nose [3] ; 

i [ 0 ] = new Acts( ) ; 

i[i] = new Clowns( ) ; 

i [ 2 ] = new Of76( ) ; 

for (int x=0; x<3; x++ ) { 

System. out . println ( i [x] . iMethod( ) 

+ " " + i [x] . getClass ( ) ); 

} 

} 
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Output 



%java Of 7 6 
5 class Acts 
7 class Clowns 
7 class Of 7 6 
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9 constructors and garbage collection 



Life and Death 
of an Object 




Objects are born and objects die. You're in charge of an object's lifecycle. 

You decide when and how to construct it. You decide when to destroy it. Except you don't 
actually destroy the object yourself, you simply abandon it. But once it's abandoned,the 
heartless Garbage Collector (gc) can vaporize it, reclaiming the memory that object was 
using. If you're gonna write Java, you're gonna create objects. Sooner or later, you're gonna 
have to let some of them go, or risk running out of RAM. In this chapter we look at how objects 
are created, where they live while they're alive, and how to keep or abandon them efficiently. 
That means we'll talk about the heap, the stack, scope, constructors, super constructors, null 
references, and more. Warning: this chapter contains material about object death that some 
may find disturbing. Best not to get too attached. 
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the stack and the heap 



The Stack and the Heap; where things live 



Before we can understand what really happens when 
you create an object, we have to step back a bit. We 
need to learn more about where everything lives 
(and for how long) in Java. That means we need to 
learn more about the Stack and the Heap. In Java, we 
(programmers) care about two areas of memory — the 
one where objects live (the heap), and the one 
where method invocations and local variables live 
(the stack). When a JVM starts up, it gets a chunk of 
memory from the underlying OS, and uses it to run 
your Java program. How much memory, and whether 
or not you can tweak it, is dependent on which 
version of the JVM (and on which platform) you’re 



running. But usually you won ’t have anything to say 
about it. And with good programming, you probably 
won’t care (more on that a little later). 

We know that all objects live on the garbage-collectible 
heap, but we haven’t yet looked at where variables 
live. And where a variable lives depends on what kind 
of variable it is. And by “kind”, we don’t mean type 
(i.e. primitive or object reference). The two kinds of 
variables whose lives we care about now are instance 
variables and £002/ variables. Local variables are also 
known as stack variables, which is a big clue for where 
they live. 



The Stack 

Where method invocations 
and local variables live 





Instance Variables 



Local Variables 



Instance variables are declared inside a class but not 
inside a method. They represent the "fields" that each 
individual object has (which can be filled with different 
values for each instance of the class). Instance variables 
live inside the object they belong to. 



public class Duck { 

int size ; ^ ^ p*tk 3 



vv s'\^ 



Local variables are declared inside a method \ including 
method parameters. They're temporary, and live only as 
long as the method is on the stack (in other words, as long as 
the method has not reached the closing curly brace). 



public void foo 
int i = x + 
boolean b = 



it x) { 

t A— 
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constructors and gc 



Methods are stacked 

When you call a method, the method lands on 
the top of a call stack. That new thing that’s 
actually pushed onto the stack is the stack 
frame, and it holds the state of the method 
including which line of code is executing, and 
the values of all local variables. 

The method at the top of the stack is always 
the currently-running method for that stack 
(for now, assume there’s only one stack, but in 
chapter 14 we’ll add more.) A method stays on 
the stack until the method hits its closing curly 
brace (which means the method’s done). If 
method foo() calls method bar(), method bar() is 
stacked on top of method foo( ). 



A call stack with two methods 







boiio*, of fhc si3£k 



local variables 
(ihdludihjj 
parameter y) 



The method on the top of the 
stack is always the currently- 
executing method. 



public void doStuff() { 
boolean b = true; 
go (4) ; 

} 

public void go(int x) { 
int z = x + 24 ; 
crazy () ; 

// imagine more code here 

} 

public void crazy () { 

char c = 'a' ; 

} 



A stack scenario 

The code on the left is a snippet (we don’t care what the rest of the 
class looks like) with three methods. The first method ( doStuff () ) calls 
the second method (go()), and the second method calls the third 
(crazy ()). Each method declares one local variable within the body 
of the method, and method go() also declares a parameter variable 
(which means go() has two local variables) . 



© 



Code from another 
class calls doStuff(), 
and doStuff () goes 
into a stack frame 
at the top of the 
stack.The boolean 
variable named 'b' 
goes on the doStuff() 
stack frame. 



IdoS-tu-p-fO l 



( 2 ) doStuff () calls go(), 
go() is pushed on 
top of the stack. 
Variables V and 'z 
are in the go() stack 
frame. 




(3) go() calls crazy(), 
crazy() is now on the 
top of the stack, 
with variable 'c in 
the frame. 




is 

popped off the stack. 
Execution goes back 
to the go() method, 
and picks up at the 
line following the call 
to crazy(). 



(4) crazy() completes, 
and its stack frame 
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object references on the stack 



What about local variables that are objects? 

Remember, a non-primitive variable holds a reference to an 
object, not the object itself. You already know where objects 
live — on the heap. It doesn’t matter where they’re declared or 
created. If the local variable is a reference to an object , only 
the variable ( the reference /remote control) goes on the stack. 

The object itself still goes in the heap. 



public class StackRef 
public void foof() 
barf () ; 

} 



public void barf() { 

Duck d = new Duck (24) ; 



* a . l’c a 1 











SU One more time, WHY are we learning the 
whole stack/heap thing? How does this help me? 
Do I really need to learn about it? 

Knowing the fundamentals of the Java 
Stack and Heap is crucial if you want to understand 
variable scope, object creation issues, memory 
management, threads, and exception handling. 

We cover threads and exception handling in later 
chapters but the others you'll learn in this one. You 
do not need to know anything about how the Stack 
and Heap are implemented in any particular JVM 
and/or platform. Everything you need to know 
about the Stack and Heap is on this page and the 
previous one. If you nail these pages,all the other 
topics that depend on your knowing this stuff will 
go much, much, much easier. Once again, some day 
you will SO thank us for shoving Stacks and Heaps 
down your throat. 
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y Java has two areas of memory we care about: 
the Stack and the Heap. 

y Instance variables are variables declared 
inside a class but outside any method. 

y Local variables are variables declared inside a 
method or method parameter. 

y All local variables live on the stack, in the 
frame corresponding to the method where the 
variables are declared. 

y Object reference variables work just like primi- 
tive variables— if the reference is declared as a 
local variable, it goes on the stack. 

y All objects live in the heap, regardless of 
whether the reference is a local or instance 
variable. 
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If local variables live on the stack, 
where do instance variables live? 



constructors and gc 



When you say new CellPhone(), Java has to make 
space on the Heap for that CellPhone. But how much 
space? Enough for the object, which means enough to 
house all of the object’s instance variables. That’s right, 
instance variables live on the Heap, inside the object 
they belong to. 

Remember that the values of an object’s instance 
variables live inside the object. If the instance variables 
are all primitives, Java makes space for the instance 
variables based on the primitive type. An int needs 
32 bits, a long 64 bits, etc. Java doesn’t care about the 
value inside primitive variables; the bit-size of an int 
variable is the same (32 bits) whether the value of the 
int is 32,000,000 or 32. 

But what if the instance variables are objects ? What if 
CellPhone HAS-A Antenna? In other words, CellPhone 
has a reference variable of type Antenna. 

When the new object has instance variables that are 
object references rather than primitives, the real 
question is: does the object need space for all of 
the objects it holds references to? The answer is, not 
exactly. No matter what, Java has to make space for the 
instance variable values. But remember that a reference 
variable value is not the whole object, but merely a remote 
control to the object. So if CellPhone has an instance 
variable declared as the non-primitive type Antenna, 
Java makes space within the CellPhone object only for 
the Antenna’s remote control (i.e. reference variable) but 
not the Antenna object. 

Well then when does the Antenna object get space on 
the Heap? First we have to find out when the Antenna 
object itself is created. That depends on the instance 
variable declaration. If the instance variable is declared 
but no object is assigned to it, then only the space for 
the reference variable (the remote control) is created. 

private Antenna ant; 

No actual Antenna object is made on the heap unless 
or until the reference variable is assigned a new 
Antenna object. 

private Antenna ant = new Antenna ( ) ; 



CellPhone object 




Object with two primitive mstdnde variables. 
Spade -for the variables lives m the object- 



CellPhone object 




Cbjedt with one non-primitive instance variable— 
a re-ferenCe to an Antenna object, but no actual 
Antenna object This is what you get i-f you 
declare the variable but don’t initialise it with 
an actual Antenna object- 

public class CellPhone { 
private Antenna ant; 

} 




Cbject with one non-primitive instance variable, 
and the Antenna variable is assigned a new 
Antenna object- 



public class CellPhone { 

private Antenna ant = new Antenna ( ) ; 

} 
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object creation 



The miracle of object creation 

Now that you know where variables and objects live, we can dive into 
the mysterious world of object creation. Remember the three steps 
of object declaration and assignment: declare a reference variable, 
create an object, and assign the object to the reference. 

But until now, step two — where a miracle occurs and the new object 
is “born” — has remained a Big Mystery. Prepare to learn the facts of 
object life. Hope you’re not squeamish. 



Review the 3 steps of object 
declaration, creation and assignment: 



O Declare a reference 
variable 

MaVc 3 A as s OV Duck myDuck = new Duck ( ) ; 






Create an object 

^ Duck myDuck = new Duck ( ) ; 






Q Link the object and 
the reference 



rt- 






Duck myDuck (^) new Duck ( ) ; 





Duck object 



Duck reference 
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constructors and gc 



Are we calling a method named Duck()? 

Because it sure looks like it. 

Duck myDuck = new Duck ( ) ; d oArc*tV* scS ‘ 

V*6a* of ? 

No. 



We’re calling the Duck constructor. 



A constructor look and feel a lot like a method, but it’s not 
a method. It’s got the code that runs when you say new. In other 
words, the code that runs when you instantiate an object. 

The only way to invoke a constructor is with the keyword new 
followed by the class name. The JVM finds that class and invokes 
the constructor in that class. (OK, technically this isn’t the only 
way to invoke a constructor. But it’s the only way to do it from 
outside a constructor. You can call a constructor from within 
another constructor, with restrictions, but we’ll get into all that 
later in the chapter.) 

But where is the constructor? 

If we didn’t write it, who did? 



a constructor has the 

code that runs when you 
instantiate an object. In 
other words, the code that 
runs when you say new on 
a class type. 

Every class you create has 
a constructor, even if you 
don’t write it yourself. 



You can write a constructor for your class (we’re about to do 
that), but if you don’t, the compiler writes one for you! 

Here’s what the compiler’s default constructor looks like: 



public Duck() { 



} 



Notice something missing? How is this 




tv* 
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constructing a new Duck 



Construct a Puck 



The key feature of a constructor is that it runs 
before the object can be assigned to a reference. 
That means you get a chance to step in and 
do things to get the object ready for use. In 
other words, before anyone can use the remote 
control for an object, the object has a chance to 
help construct itself. In our Duck constructor, 
we’re not doing anything useful, but it still 
demonstrates the sequence of events. 



public class Duck { 



public Duck() { 

System. out .pr in tin ("Quack") ; 



} 



« , 

CoKsW-t®*- 




tode 



The constructor gives 
you a chance to step into 
the middle of new. 



public class UseADuck { 



public static void main (String [] args) { 
Duck d = new Duck ( ) ; 

} 









% java UseADuck 
Quack 






ai wen pci Ml 



A constructor lets you jump into the middle 
of the object creation step — into the middle 
of new. Can you imagine conditions where 
that would be useful? Which of these might 
be useful in a Car class constructor, if the Car 
is part of a Racing Game? Check off the ones 
that you came up with a scenario for. 



□ Increment a counter to track how many objects of this class type 
have been made. 

□ Assign runtime-specific state (data about what’s happening NOW). 

□ Assign values to the object’s important instance variables. 

□ Get and save a reference to the object that’s creating the new object. 

□ Add the object to an ArrayList. 

□ Create HAS-A objects. 

□ (your idea here) 
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constructors and gc 



Initializing the state of a new Puck 

Most people use constructors to initialize the state of an object. 
In other words, to make and assign values to the object’s 
instance variables. 

public Duck() { 
size = 34; 

} 

That’s all well and good when the Duck class developer knows 
how big the Duck object should be. But what if we want the 
programmer who is using Duck to decide how big a particular 
Duck should be? 

Imagine the Duck has a size instance variable, and you want the 
programmer using your Duck class to set the size of the new 
Duck. How could you do it? 

Well, you could add a setSize() setter method to the class. But 
that leaves the Duck temporarily without a size*, and forces the 
Duck user to write two statements — one to create the Duck, and 
one to call the setSize() method. The code below uses a setter 
method to set the initial size of the new Duck. 

public class Duck { 

int size; ^ ^' aWe 

public Duck() { 

System. out .println ("Quack") ; ^ 

} 

public void setSize(int newSize) { 
size = newSize; 

} 

} 



public class UseADuck { 



public static void main 
Duck d = new Duck ( ) 



d. setSize (42) 



} 



(String [] args) { 

"" *£ it"* tv 

instance variables do have a default value. 0 or 
0.0 for numeric primitives, false for booleans, and 
null for references. 



one 




Why do you need to write 
a constructor if the compiler 
writes one for you? 

If you need code to help 
initialize your object and get 
it ready for use, you'll have to 
write your own constructor. You 
might, for example, be depen- 
dent on input from the user 
before you can finish making 
the object ready. There's another 
reason you might have to write 
a constructor, even if you don't 
need any constructor code 
yourself. It has to do with your 
superclass constructor, and we'll 
talk about that in a few minutes. 



How can you tell a con- 
structor from a method? Can 
you also have a method that's 
the same name as the class? 

Java lets you declare a 
method with the same name as 
your class. That doesn't make it 
a constructor, though. The thing 
that separates a method from a 
constructor is the return type. 
Methods must have a return 
type, but constructors cannot 
have a return type. 



Are constructors inher- 
ited? If you don't provide a 
constructor but your superclass 
does, do you get the superclass 
constructor instead of the 
default? 



Nope. Constructors are 
not inherited. We'll look at that in 
just a few pages. 



you are here ► 243 



Head First Java, 2nd Edition. Head First Java, 2nd Edition, ISBN: 0596009208 

Prepared for e.simons@icarin.fiuc.org, Eduard Simons 

Copyright © 2005 Bert Bates and Kathy Sierra. This PDF is made available for personal use only during the relevant subscription term, subject to the Safari Terms of Service. Any other use 
requires prior written consent from the copyright owner. Unauthorized use, reproduction and/or distribution are strictly prohibited and violate applicable laws. All rights reserved. 



initializing object state 



Using the constructor to initialize 
important Puck state* 

If an object shouldn’t be used until one or 
more parts of its state (instance variables) have 
been initialized, don’t let anyone get ahold of 
a Duck object until you’re finished initializing! 

It’s usually way too risky to let someone make — 
and get a reference to — a new Duck object that 
isn’t quite ready for use until that someone turns 
around and calls the setSize() method. How will 
the Duck-user even know that he’s required to call 
the setter method after making the new Duck? 

The best place to put initialization code is in the 
constructor. And all you need to do is make a 
constructor with arguments. 

public class Duck { 
int size; 




public Duck (int duckSize) { 

System. out .pr in tin ("Quack") ; 



size = duckSize; 




Use the value to set 

•tv* size instate vaviable- 



} 



System. out .println ("size is " + size); 



public class UseADuck { 



public static void main (String [] args) { 



} 



,’s O'M^' 

v 



\k> ^ 



Duck d = new Duck (42) 



^N^^dl^A/indovi^eT^^oni^ 



% java UseADuck 



Quack 






, Pa “/ ^ to the 
Constructor 



size is 42 



*Not to imply that not all Duck state is not unimportant. 
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constructors and gc 



Make it easy to make a Puck 

Pe sore yoo have a no-arg constructor 



What happens if the Duck constructor takes an argument? 

Think about it. On the previous page, there’s only on^Duck 
constructor — and it takes an int argument for the size of the 
Duck. That might not be a big problem, but it does make it 
harder for a programmer to create a new Duck object, especially 
if the programmer doesn’t know what the size of a Duck should 
be. Wouldn’t it be helpful to have a default size for a Duck, so 
that if the user doesn’t know an appropriate size, he can still 
make a Duck that works? 

Imagine that you want Duck users to have TWO options 
for making a Duck— one where they supply the Duck 
size (as the constructor argument) and one where they 
don’t specify a size and thus get your default Duck size. 

You can’t do this cleanly with just a single constructor. 
Remember, if a method (or constructor — same rules) has 
a parameter, you must pass an appropriate argument when 
you invoke that method or constructor. You can’t just say, “If 
someone doesn’t pass anything to the constructor, then use 
the default size”, because they won’t even be able to compile 
without sending an int argument to the constructor call. You 
could do something clunkly like this: 



public class Duck { 
int size; 

public Duck (int newSize) 
if (newSize == 0) { 

size = 27; 

} else { 

size = newSize; 



} 



} 



tv* 



MaW« * 






VAS t 



hot 

tv* f'** 

soW^' 0 ’" 



But that means the programmer making a new Duck object has 
to know that passing a “0” is the protocol for getting the default 
Duck size. Pretty ugly. What if the other programmer doesn’t 
know that? Or what if he really does want a zero-size Duck? 
(Assuming a zero-sized Duck is allowed. If you don’t want 
zero-sized Duck objects, put validation code in the constructor 
to prevent it.) The point is, it might not always be possible 
to distinguish between a genuine “I want zero for the size” 
constructor argument and a “I’m sending zero so you’ll give 
me the default size, whatever that is” constructor argument. 



You really want TWO ways to 
make a new Duck: 

public class Duck2 { 

int size; 

public Duck2() { 

// supply default size 
size = 27; 

} 

public Duck2 (int duckSize) { 
// use duckSize parameter 
size = duckSize; 

} 

} 



To make a Duck when you know the size: 
Duck2 d = new Duck2 (15) ; 

To make a Duck when you do not know 
the size: 

Duck2 d2 = new Duck2 ( ) ; 

So this two-options-to-make-a-Duck idea 
needs two constructors. One that takes 
an int and one that doesn't. If you have 
more than one constructor in a class, 
it means you have overloaded 
constructors . 
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overloaded and default constructors 



doesn't the compiler always 
make a wo-arg constructor 
for you? \\o\ 

You might think that if you write only 
a constructor with arguments, the 
compiler will see that you don’t have a 
no-arg constructor, and stick one in for 
you. But that’s not how it works. The 
compiler gets involved with constructor- 
making only if you don ’t say anything at all 
about constructors. 

If you write a constructor that 
takes arguments, and you still 
want a no-arg constructor, 
you’ll have to build the no-arg 
constructor yourself! 

As soon as you provide a constructor, 

ANY kind of constructor, the compiler 
backs off and says, “OK Buddy, looks like 
you’re in charge of constructors now.” 

If you have more than one 
constructor in a class, the 
constructors MUST have 
different argument lists. 

The argument list includes the order 
and types of the arguments. As long as 
they’re different, you can have more 
than one constructor. You can do this 
with methods as well, but we’ll get to that 
in another chapter. 
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constructors and gc 



Overloaded constructors means you have 
more than one constructor in your class. 

To compile, each constructor must have a 
different argument list! 



The class below is legal because all four constructors have 
different argument lists. If you had two constructors that took 
only an int, for example, the class wouldn’t compile. What you 
name the parameter variable doesn’t count. It’s the variable 
type (int, Dog, etc.) and order that matters. You can have two 
constructors that have identical types, as long as the order is 
different. A constructor that takes a String followed by an int, is 
not the same as one that takes an int followed by a String. 





public class Mushroom { * '»£ it's 

public Mushroom (int SizG) { } 



public Mushroom ( ) { } 






* don’t VHom**^** 



, Uno'N •>£ it’s <*■ 



Y\0*t) 



public Mushroom (boolean isMagic) { } 

•these W tow the (public Mushroom (boolean isMagic, int size) { > ) or *>ot 

dSevSoi "- 50 (public Mushroom (int size, boolean isMagic) { > \ S 

ft's 0^ } 



kv>ow 



y Instance variables live within the object they belong to, on 
the Heap. 

y If the instance variable is a reference to an object, both 
the reference and the object it refers to are on the Heap. 

y A constructor is the code that runs when you say new on 
a class type. 

y A constructor must have the same name as the class, and 
must not have a return type. 

y You can use a constructor to initialize the state (i.e. the 
instance variables) of the object being constructed. 

y If you don’t put a constructor in your class, the compiler 
will put in a default constructor. 

y The default constructor is always a no-arg constructor. 

y If you put a constructor— any constructor— in your class, 
the compiler will not build the default constructor. 



y If you want a no-arg constructor, and you’ve already put 
in a constructor with arguments, you’ll have to build the 
no-arg constructor yourself. 

y Always provide a no-arg constructor if you can, to make it 
easy for programmers to make a working object. Supply 
default values. 

y Overloaded constructors means you have more than one 
constructor in your class. 

y Overloaded constructors must have different argument 
lists. 

y You cannot have two constructors with the same 

argument lists. An argument list includes the order and/or 
type of arguments. 

y Instance variables are assigned a default value, even 
when you don’t explicitly assign one. The default values 
are 0/0.0/false for primitives, and null for references. 
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overloaded constructors 



^jbarpen your pencil 

Match the new Di 



Match the new Duck () call with the constructor 
that runs when that Duck is instantiated. We did 
the easy one to get you started. 



public class TestDuck { 



class Duck { 

int pounds = 6; 

float floatability = 2. IF; 

String name = "Generic" ; 

long [ ] feathers = {1,2, 3, 4, 5, 6, 7}; 

boolean canFly = true; 

int maxSpeed = 25; 



public static void main (String[] args) { 

int weight = 8 ; 
float density = 2.3F; 

String name = "Donald" 
long [ ] feathers = { 1 , 2, 3, 4, 5, 6 } ; 
boolean canFly = true; 
int airspeed = 22; 

Duck [ ] d = new Duck [ 7 ] 

d [ 0 ] = new Duck ( ) ; 

d[l] = new Duck (density , weight); 

d[2] = new Duck (name, feathers); 

d[3] = new Duck (canFly) ; 

d[4] = new Duck(3.3F, airspeed); 

d[5] = new Duck(false); 

d[6] = new Duck (airspeed, density); 



public Duck ( ) { 

System . out . println ( " type 1 duck" ) ; 

} 

public Duck (boolean fly) { 
canFly = fly; 

System . out . println ( " type 2 duck" ) ; 

} 

public Duck (String n, long[] f) { 
name = n; 
feathers = f; 

System . out . println ( " type 3 duck" ) ; 

} 

public Duck (int w, float f) { 
pounds = w ; 
floatability = f; 

System . out . println ( " type 4 duck" ) ; 

} 



public Duck (float density, int max) { 
floatability = density; 
maxSpeed = max; 

System . out . println ( " type 5 duck" ) ; 

} 



X : Earlier you said that it's good to have a no-argu- 
ment constructor so that if people call the no-arg con- 
structor, we can supply default values for the "missing" 
arguments. But aren't there times when it's impossible to 
come up with defaults? Are there times when you should 
not have a no-arg constructor in your class? 

You're right. There are times when a no-arg construc- 
tor doesn't make sense. You'll see this in the Java API — some 
classes don't have a no-arg constructor.The Color class, for 
example, represents a... color. Color objects are used to, for 
example, set or change the color of a screen font or GUI 
button. When you make a Color instance, that instance is 
of a particular color (you know, Death-by-Chocolate Brown, 
Blue-Screen-of-Death Blue, Scandalous Red, etc.). If you 
make a Color object, you must specify the color in some way. 

Color c = new Color (3 , 45 ,200) ; 



(We're using three ints for RGB values here. We'll get into 
using Color later, in the Swing chapters.) Otherwise, what 
would you get? The Java API programmers could have de- 
cided that if you call a no-arg Color constructor you'll get a 
lovely shade of mauve. But good taste prevailed. 

If you try to make a Color without supplying an argument: 

Color c = new Color () ; 

The compiler freaks out because it can't find a matching no- 
arg constructor in the Color class. 
^iT^^diMA/indovi^eT^topBeingStupi^^^^^^ 



cannot resolve symbol 
: constructor Color () 
location: class 
java.awt. Color 
Color c = new Color () ; 

A 

1 error 
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constructors and gc 



Naworeview: four things to 
remember about constructors 



(T) A constructor is the code that runs when 
somebody says new on a class type 

Duck d = new Duck ( ) ; 



© A constructor must have the same name 
as the class, and no return type 

public Duck(int size) { } 



( 3 ) If you don't put a constructor in your class, 
the compiler puts in a default constructor. 
The default constructor is always a no-arg 
constructor. 

public Duck() { } 



© 



You can have more than one constructor in your class, 
as long as the argument lists are different. Having 
more than one constructor in a class means you have 
overloaded constructors. 



public Duck() { } 

public Duck(int size) { } 

public Duck (String name) { } 

public Duck (String name, int size) { } 



Doing all the Brain Barbells has been shown to produce a 42% increase in 
neuron size. And you know what they say, “Big neurons...” 







1 * 



What about superclasses? 

When you make a Dog, 
should the Canine 
constructor run too? 

If the superclass is abstract, 
should it even have a 
constructor? 



Well look at this on the next 
few pages, so stop now and 
think about the implications of 
constructors and superclasses. 





Do constructors have to be public? 



No. Constructors can be public, 
private, or default (which means no access 
modifier at all). We'll look more at default 
access in chapter 16 and appendix B. 



O: How could a private constructor 
ever be useful? Nobody could ever call it, 
so nobody could ever make a new object! 



But that's not exactly right. Marking 
something private doesn't mean nobody 
can access it, it just means that nobody 
outside the class can access it. Bet you're 
thinking "Catch 22" Only code from the 
same class as the class-with-private-con- 
structor can make a new object from that 
class, but without first making an object, 
how do you ever get to run code from that 
class in the first place? How do you ever get 
to anything in that class? Patience grasshop- 
per. We'll get there in the next chapter. 
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space for an object’s superclass parts 



Wait a minute... we never W talk about 
superclasses and inheritance and how that all 
fits in with constructors. 

Here’s where it gets fun. Remember from the last chapter, the part where we looked at 
the Snowboard object wrapping around an inner core representing the Object portion 
of the Snowboard class? The Big Point there was that every object holds not just its own 
declared instance variables, but also everything from its superclasses (which, at a minimum, 
means class Object, since every class extends Object). 

So when an object is created (because somebody said new; there is no other way to create 
an object other than someone, somewhere saying new on the class type), the object 
gets space for all the instance variables, from all the way up the inheritance tree. Think 
about it for a moment... a superclass might have setter methods encapsulating a private 
variable. But that variable has to live somewhere. When an object is created, it’s almost as 
though multiple objects materialize — the object being new’d and one object per each 
superclass. Conceptually, though, it’s much better to think of it like the picture below, 
where the object being created has layers of itself representing each superclass. 



Object 




equals() 

getClass() 

hashCode() 

toStringO 



Snowboard 



Foox 

Fooy 

intz 



turn() 

shred() 

getAir() 

loseControl() 



Objedt has instande variables 
encapsulated by addess methods. 
Those instance variables are 
dreated when any subdlass is 
instantiated- (These aren’t the 
Objedt variables, but we 
don’t dare what they are sinde 
they’re endapsulated) 

Snowboard also has instande 
variables o-P its own, so to make 
a Snowboard objedt we need 
spade -for the instande variables 
o-P both dlasses. 




There is on ly ONE objedt on the heap here- A 
Snowboard objedt- But it dontains both the 
Snowboard parts o-P itsel-P and the J)b \edt parts o-P 
itsel-P- AH instande variables -Pv-om both dlasses have 
to be here- 
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The role of superclass constructors 
in an object's life. 



constructors and gc 



All the constructors in an object’s inheritance 
tree must run when you make a new object 

Let that sink in. 





Hippo 



That means every superclass has a constructor 
(because every class has a constructor) , and each 
constructor up the hierarchy runs at the time an 
object of a subclass is created. 

Saying new is a Big Deal. It starts the 
whole constructor chain reaction. And yes, 
even abstract classes have constructors. 

Although you can never say new on an 
abstract class, an abstract class is still 
a superclass, so its constructor runs 
when someone makes an instance of a 
concrete subclass. 

The super constructors run to build 
out the superclass parts of the object. 

Remember, a subclass might inherit 
methods that depend on superclass state 
(in other words, the value of instance variables 
in the superclass). For an object to be fully- 
formed, all the superclass parts of itself must be 
fully-formed, and that’s why the super constructor 
must run. All instance variables from every class 
in the inheritance tree have to be declared and 
initialized. Even if Animal has instance variables 
that Hippo doesn’t inherit (if the variables are 
private, for example), the Hippo still depends on 
the Animal methods that use those variables. 

When a constructor runs, it immediately calls its 
superclass constructor, all the way up the chain 
until you get to the class Object constructor. 



A single Hippo objedt ov> -tbe heap 



A new Hippo object also IS-A Animal 
and IS-A Object. If you want to make a 
Hippo, you must also make the Animal 
and Object parts of the Hippo. 

This all happens in a process called 

Constructor Chaining. 



On the next few pages, you’ll learn how superclass 
constructors are called, and how you can call 
them yourself. You’ll also learn what to do if your 
superclass constructor has arguments! 
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object construction 



Making a Hippo means making the 
Animal and Object parts too... 



public class Animal { 
public Animal ( ) { 

System . out . println ( "Making an Animal" ) ; 

} 

} 



public class Hippo extends Animal { 
public Hippo () { 

System . out . println ( "Making a Hippo" ) ; 

} 

} 



public class TestHippo { 

public static void main (String [] args) { 
System. out .println ("Starting. . .") ; 
Hippo h = new Hippo ( ) ; 

} 

} 




What's the real output? Given the 
code on the left, what prints out 
when you run TestHippo? A or B? 



(the answer is at the bottom of the page) 
^ik^di^A/indov^eT[^wea^^^^^ 



% java TestHippo 
Starting . . . 
Making an Animal 
Making a Hippo 



^IT^^diMA/indov^eT^^wea^^^^^ 



% java TestHippo 
Starting . . . 
Making a Hippo 
Making an Animal 



© 



Code from another 
class says new 
Hippo ( ) and the 
Hippo() constructor 
goes into a stack 
frame at the top of 
the stack. 




( 2 ) Hippo() invokes 
the superclass 
constructor which 
pushes the Animal() 
constructor onto the 
top of the stack. 




( 3 ) Animal() invokes 
the superclass 
constructor which 
pushes the Object() 
constructor onto 
the top of the stack, 
since Object is the 
superclass of Animal. 



/WliwdIO 




(4) Object() completes, 
and its stack frame 
is popped off the 
stack. Execution goes 
back to the Animal() 
constructor, and 
picks up at the line 
following Animal's 
call to its superclass 
constructor 




■JSJjJ SQlISjlMJ }Bl|} JOJOnjJSUOO leilMUV 9 l|l S,}! 
jnq ‘jsjy pe^OAin s; jojorujsuoo Qoddm 0111 - v ‘ 9 uo jsjlj siy. 
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How do you invoke a superclass constructor? 



constructors and gc 



You might think that somewhere in, say, a Duck constructor, 
if Duck extends Animal you’d call Animal () . But that’s not 
how it works: 

public class Duck extends Animal { 
int size; 






public Duck (int newSize) { 

Animal ( ) ; 4. 

size = newSize; 

} 



No! r, . . 

' w is 



hoi %>// 



The only way to call a super constructor is by calling super (). 
That’s right — super ( ) calls the super constructor. 

What are the odds? 

public class Duck extends Animal { 
int size; 



public Duck (int newSize) { 



super () ; <- 

size = newSize; 



you >* «y *up*o 



} 



} 



A call to super() in your constructor puts the superclass 
constructor on the top of the Stack. And what do you 
think that superclass constructor does? Calls its superclass 
constructor. And so it goes until the Object constructor is 
on the top of the Stack. Once Object() finishes, it’s popped 
off the Stack and the next thing down the Stack (the 
subclass constructor that called Object()) is now on top. 
That constructor finishes and so it goes until the original 
constructor is on the top of the Stack, where it can now 
finish. 



And how is it that we’ve 
gotten away without 
doing it? 

You probably figured that out. 

Our good friend the compiler 
puts in a call to super() if you 
don't. 

So the compiler gets involved in 
constructor-making in two ways: 

(l) If you don't provide a constructor 

The compiler puts one in that looks like: 

public ClassName() { 
super ( ) ; 

} 

( 5 ) If you do provide a constructor 
but you do not put in the call to 
super() 

The compiler will put a call to super() in 
each of your overloaded constructors* 

The compiler-supplied call looks like: 

super ( ) ; 

It always looks like that. The compiler- 
inserted call to super() is always a no-arg 
call. If the superclass has overloaded 
constructors, only the no-arg one is called. 

*Unless the constructor calls another overloaded 
constructor (you’ll see that in a few pages). 
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object lifecycle 



Can the child exist before 




^ Eewwww... that ^ 
is SO creepy. There's 
no way I could have been 
born before my parents. 

That's just wrong. 



the parents? 



If you think of a superclass as the parent to the subclass child, 
you can figure out which has to exist first. The superclass parts 
of an object have to be fully-formed (completely built ) before the 
subclass parts can be constructed. Remember, 
the subclass object might depend on things it 
inherits from the superclass, so it’s important 
that those inherited things be finished. No 
way around it. The superclass constructor 
must finish before its subclass constructor. 



Look at the Stack series on page 248 again, 
and you can see that while the Hippo 
constructor is the first to be invoked (it’s 
the first thing on the Stack) , it’s the last one 
to complete! Each subclass constructor 
immediately invokes its own superclass 
constructor, until the Object constructor 
is on the top of the Stack. Then Object’s 
constructor completes and we bounce 
back down the Stack to Animal’s 
constructor. Only after Animal’s constructor completes 
do we finally come back down to finish the rest of the Hippo 
constructor. For that reason: 



The call to super() must be the first statement 
in each constructor!* 
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constructors and gc 



Superclass constructors with arguments 

What if the superclass constructor has arguments? Can you pass something in to 
the super() call? Of course. If you couldn’t, you’d never be able to extend a class 
that didn’t have a no-arg constructor. Imagine this scenario: all animals have a 
name. There’s a getName() method in class Animal that returns the value of the 
name instance variable. The instance variable is marked private, but the subclass 
(in this case, Hippo) inherits the getName() method. So here’s the problem: 

Hippo has a getName() method (through inheritance), but does not have the name 
instance variable. Hippo has to depend on the Animal part of himself to keep the 
name instance variable, and return it when someone calls getName() on a Hippo 
object. But... how does the Animal part get the name? The only reference Hippo 
has to the Animal part of himself is through super(), so that’s the place where 
Hippo sends the Hippo’s name up to the Animal part of himself, so that the 
Animal part can store it in the private name instance variable. 

public abstract class Animal { 

private String name; 4- AH anir»aU (mfclwimj 

subclasses) have a *arwe 

public String getName() { 4 A A .// 

return name ; ™ppo M 

} 



public Animal (String theName) { 
name = theName; 

} 






Animal 



private String name 



Animal(String n) 



String getNameQ 



I 



Hippo 



Hippo(String n) 



[other Hippo-spe- 
cific methods] 



The Animal part of 
me needs to know my name, 
so I take a name in my own 
Hippo constructor, then pass 
the name to superQ 



public class Hippo extends Animal { 



public Hippo (String name) { , 1 r -bakes a 

super (name) ; ft??® <*****’ or 

> 




public class MakeHippo { 

public static void main (String [ ] args) { Wdkc a ffj pp 

Hippo h = new Hippo ("Buff y") ; 4 . Bu-pfy ike 

System, out. println (h. getName () ) ; ff , pp^ ^ «■> 



File Edit Window Help Hide 



;java MakeHippo 



Buffy 
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calling overloaded constructors 



Invoking one overloaded constructor 
from another 



What if you have overloaded constructors that, with 
the exception of handling different argument types, 
all do the same thing? You know that you don’t want 
duplicate code sitting in each of the constructors (pain 
to maintain, etc.), so you’d like to put the bulk of the 
constructor code (including the call to super ()) in only 
one of the overloaded constructors. You want whichever 
constructor is first invoked to call The Real Constructor 
and let The Real Constructor finish the job of 
construction. It’s simple: just say this(). Or this(aString). 
Or this( 27 , x). In other words, just imagine that the 
keyword this is a reference to the current object 

You can say this() only within a constructor, and it must 
be the first statement in the constructor! 

But that’s a problem, isn’t it? Earlier we said that 
super () must be the first statement in the constructor. 
Well, that means you get a choice. 

Every constructor can have a call to super() 
or this(), but never both! 



Use thisO to call a 

constructor W an » tWr 

overloaded constructor in 

tlie same class- 

TUe call to tWO 
c a„ teased only i« a 
constructor, and must te 
t W lirst statement in a 

constructor. 

A constructor can tave a 

Zti 

kut never Wn. 



class Mini extends Car { 

Color color; 

public Mini ( ) { 

this (Color . Red) ; 

} 

public Mini (Color c) 
super ( "Mini " ) ; ^ — 



TV* 

tails the over Uded M 

Cor-strutW (tte ore that 

tails sufev-Oy 



color = c; 

// more initialization 



Th.s is The Real ConsW-U that 
lyeet Wludmj the call to superO) 



r 



public Mini(int size) { 
this (Color . Red) ; * ; 

super (size) ; A— — — Wort work// Car't have 

^ *d thisO ir the same 



File Edit Window Help Drive 



j avac Mini . j ava 



Wruttor beeause they eath 
■nnst be the -first statement'"' 




Mini . j ava : 1 6 : call to super must 
be first statement in constructor 

super () ; 
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constructors and gc 




Some of the constructors in the SonOfBoo class will not 
compile. See if you can recognize which constructors are 
not legal. Match the compiler errors with the SonOfBoo 
constructors that caused them, by drawing a line from the 
compiler error to the "bad" constructor. 

public class Boo { 

public Boo(int i) { } 
public Boo (String s) { } 
public Boo (String s, int i) { } 

} 



class SonOfBoo extends Boo { 

public SonOfBoo () { 

super ("boo") ; 

} 

public SonOfBoo (int i) { 
super ("Fred") ; 

} 

public SonOfBoo (String s) { 
super (42) ; 

} 

public SonOfBoo (int i. String s) { 

} 

public SonOfBoo (String a, String b. String c) 
super ( a, b) ; 

} 

public SonOfBoo (int i, int j) { 
super ( "man " , j ) ; 

} 

public SonOfBoo (int i, int x, int y) { 
super ( i , " s tar " ) ; 

} 



' lfak * * Si§i 







File Edit Window Help 



%javac SonOfBoo . java 
cannot resolve symbol 

symbol : constructor Boo 
( j ava . lang . String , j ava . la 
ng . String) 



^il^^diMA/Jndov^ei^^dayadayad^™ 



%javac SonOfBoo . java 

cannot resolve symbol 

symbol : constructor Boo 
(int , j ava . lang . String) 



| File Edit Window Help ImNotListening 


% j avac 


SonOfBoo . j ava 


cannot 


resolve symbol 


symbol : 


[constructor Boo() 
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object lifespan 



Now we know how aw object is born, 
but how long does an object live ? 

An object’s life depends entirely on the life of references 
referring to it. If the reference is considered “alive”, the 
object is still alive on the Heap. If the reference dies 
(and we’ll look at what that means in just a moment), the 
object will die. 

So if an object’s life depends on the reference 
variable’s life, how long does a variable live? 

That depends on whether the variable is a local variable 
or an instance variable. The code below shows the life of a 
local variable. In the example, the variable is a primitive, 
but variable lifetime is the same whether it’s a primitive 
or reference variable. 

public class TestLifeOne { 

public void read() { 

int s = 42; ^ . 

sleep () ; 

} 

public void sleep () { 



s = 7; 





e i* **•'* i 



(D A local variable lives only 
within the method that 
declared the variable. 

public void read() { 
int s = 42 ; 

// 's' can be used only 
// within this method. 

// When this method ends, 

// 's' disappears completely. 

} 

Variable's' can be used only within the 
read() method. In other words, the variable 
is in scope only within its own method. No 
other code in the class (or any other class) 
can see's'. 



0 An instance variable lives 
as long as the object 
does. If the object is still 
alive, so are its instance 
variables. 

public class Life { 
int size; 

public void setSize(int s) { 
size = s; 

// 's' disappears at the 
// end of this method, 

// but 'size' can be used 
// anywhere in the class 

} 

} 

Variable 's' (this time a method parameter) 
is in scope only within the setSizeO 
method. But instance variable size is 
scoped to the life of the object as opposed 
to the life of the method. 
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constructors and gc 



The difference between life and 
scope for local variables: 

Life 

A local variable is alive as long as its Stack 
frame is on the Stack. In other words, 
until the method completes. 

Scope 

A local variable is in scope only within the 
method in which the variable was declared. 
When its own method calls another, the 
variable is alive, but not in scope until its 
method resumes. You can use a variable only 
when it is in scope. 



public void doStuff() { 
boolean b = true; 
go (4) ; 

} 

public void go(int x) { 
int z = x + 24; 
crazy () ; 

// imagine more code here 

} 

public void crazy () { 

char c = 'a' ; 

} 




doStufff) goes on the 
Stack. Variable ‘b’ is 
alive and in scope. 



O 



go() plops on top of 
the Stack, ‘x’ and ‘z’ 
are alive and in scope, 
and ‘b’ is alive but not 
in scope. 



A crazy() is pushed onto 
the Stack, with ‘c’ now 
alive and in scope. The 
other three variables 
are alive but out of 
scope. 



While a local variable is alive, its state persists. 

As long as method doStuff() is on the Stack, for 
example, the ‘b’ variable keeps its value. But the 
‘b’ variable can be used only while doStuff() ’s 
Stack frame is at the top. In other words, you can 
use a local variable only while that local variable’s 
method is actually running (as opposed to 
waiting for higher Stack frames to complete). 



A crazy() completes and 
^ is popped off the Stack, 
so ‘c’ is out of scope 
and dead. When go() 
resumes where it left 
off, ‘x’ and ‘z’ are both 
alive and back in scope. 
Variable ‘b’ is still alive 
but out of scope (until 
go() completes). 
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object lifecycle 



What about reference variables? 



The rules are the same for primtives and references. A reference 
variable can be used only when it’s in scope, which means you can’t use 
an object’s remote control unless you’ve got a reference variable that’s 
in scope. The real question is, 

“How does variable life affect object life?” 

An object is alive as long as there are live references to it. If a reference 
variable goes out of scope but is still alive, the object it refers to is still 
alive on the Heap. And then you have to ask... “What happens when the 
Stack frame holding the reference gets popped off the Stack at the end 
of the method?” 

If that was the only live reference to the object, the object is now 
abandoned on the Heap. The reference variable disintegrated with 
the Stack frame, so the abandoned object is now, officially, toast. The 
trick is to know the point at which an object becomes eligible for garbage 
collection. 

Once an object is eligible for garbage collection (GC), you don’t have 
to worry about reclaiming the memory that object was using. If your 
program gets low on memory, GC will destroy some or all of the eligible 
objects, to keep you from running out of RAM. You can still run out of 
memory, but not before all eligible objects have been hauled off to the 
dump. Your job is to make sure that you abandon objects (i.e, make 
them eligible for GC) when you’re done with them, so that the garbage 
collector has something to reclaim. If you hang on to objects, GC can’t 
help you and you run the risk of your program dying a painful 
out-of-memory death. 



An object’s life has no 
value, no meaning, no 
point, unless somebody 
has a reference to it. 

If you can’t get to it, 
you can’t ask it to do 
anything and it’s just a 
big fat waste of bits. 

But if an object is 
unreachable, the 
Garbage Collector will 
figure that out. Sooner 
or later, that object’s 
goin’ down. 




An object becomes 
eligible for GC when 
its last live reference 
disappears. 



Three ways to get rid of an object’s reference: 

d'.es at 



(?) The reference goes out of scope, permanently 

void go() { vefeven^ *- 

Life z = new Life() ; vwethod 

(5) The reference is assigned another object ^ 

Life z = new Lif e () ; ^ “t 0 



Life z = new Life() ; 
z = new Life() ; 



-sVcyro^a— 



a re* 

( 3 ) The reference is explicitly set to null . , 

Life z = new Life(); 



z = null; 



<r 



vjhort 
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constructors and gc 



Object-killer #1 



Reference goes 
out of scope, 
permanently. 




public class StackRef { 



} 



foof() is pushed onto the 
Stack, no variables are 
declared. 



public void foof() { 
barf () ; 

} 

public void barf ( ) { 

Duck d = new Duck ( ) ; 

} 





© 



barf() is pushed onto the 
Stack, where it declares 
a reference variable, and 
creates a new object as- 
signed to that reference. 
The object is created on 
the Heap, and the refer- 
ence is alive and in scope. 




o 

a'" 1 *' 



J barf() completes and pops 
off the Stack. Its frame 
disintegrates, so ‘d’ is now 
dead and gone. Execution 
returns to foof(), but foof() 
can’t use ‘d’ . 



«•••» 

i-i 



d « 





Uh— oh. The 'd ; variable 
v/e^-t away whe* the bar-fO 
Stack -fv-a^e was blown 
off the stack, so the Duck 
is abandoned- ^av-baje— 
ColleCtov bait* 
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object lifecycle 



Object-killer #2 




public class ReRef { 

Duck d = new Duck ( ) ; 

public void go() { 
d = new Duck ( ) ; 

} 



Dude, all you 
had to do was reset 
the reference. Guess 
they didn't have memory 
management back then. 





>d’ is assigned a n«w obyd-t, leaving 
original tfivst) Pvdk objed-t abandoned- That 

-first Pvtk ,s *°'* J as 5 00< * as 



Tbe new Dvdk goes on tbe ttea ? , re^erended 
by 'd'- Sinde 'd' is an insiande variable, tbe 
pudk will live as long as tbe ReRe-f objedt 
that instantiated it is alive- Unless- 



v-e{ ccl* u 

{or a 
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constructors and gc 



Object-killer #3 



Explicitly set the 
reference to null 




public class ReRef { 

Duck d = new Duck ( ) ; 

public void go ( ) { 

d = null; 

} 



The meaning of null 

When you set a reference to null, you're 
deprogramming the remote control. 

In other words, you've got a remote 
control, but no TV at the other end. A null 
reference has bits representing 'null' (we 
don't know or care what those bits are, as 
long as the JVM knows). 

If you have an unprogrammed remote 
control, in the real world, the buttons don't 
do anything when you press them. But 
in Java, you can't press the buttons (i.e. 
use the dot operator) on a null reference, 
because the JVM knows (this is a runtime 
issue, not a compiler error) that you're 
expecting a bark but there's no Dog there 
to do it! 

If you use the dot operator on 
a null reference, you'll get a 
NullPointerException at runtime. You'll 
learn all about Exceptions in the Risky 
Behavior chapter. 




, e „ ew Dudk yes on the Heap, referenced 

l d’. S'mte 'd' is a« insiante vaviable, the 
,dk Will live as long as the ReRe-C objedt 




'd' is set to null, *bidb is just like having a remote 
dontvol that isn't ^a-ed to anything. Vou,e not 
even allowed to use the dot o F eraW on d unt.l >ts 
vefvogvammed (assigned an objedt)- 
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object lifecycle 




Fireside Chats 



Tonight’s Talk: An instance variable and 
a local variable discuss life and death 
(with remarkable civility) 



Instance Variable 

I’d like to go first, because I tend to be more 
important to a program than a local variable. 
I’m there to support an object, usually 
throughout the object’s entire life. After all, 
what’s an object without state ? And what is 
state? Values kept in instance variables. 



No, don’t get me wrong, I do understand your 
role in a method, it’s just that your life is so 
short. So temporary. That’s why they call you 
guys “temporary variables”. 

My apologies. I understand completely. 



I never really thought about it like that. What 
are you doing while the other methods are 
running and you’re waiting for your frame to 
be the top of the Stack again? 



Local Variable 



I appreciate your point of view, and I certainly 
appreciate the value of object state and all, 
but I don’t want folks to be misled. Local 
variables are really important. To use your 
phrase, “After all, what’s an object without 
behavior ?” And what is behavior? Algorithms 
in methods. And you can bet your bits there’ll 
be some local variables in there to make those 
algorithms work. 

Within the local-variable community, the 
phrase “temporary variable” is considered 
derogatory. We prefer “local”, “stack”, “auto- 
matic”, or ’’Scope-challenged”. 

Anyway, it’s true that we don’t have a long 
life, and it’s not a particularly good life either. 
First, we’re shoved into a Stack frame with 
all the other local variables. And then, if the 
method we’re part of calls another method, 
another frame is pushed on top of us. And if 
that method calls another method... and so on. 
Sometimes we have to wait forever for all the 
other methods on top of the Stack to com- 
plete so that our method can run again. 

Nothing. Nothing at all. It’s like being in 
stasis — that thing they do to people in science 
fiction movies when they have to travel long 
distances. Suspended animation, really. We 
just sit there on hold. As long as our frame is 
still there, we’re safe and the value we hold 
is secure, but it’s a mixed blessing when our 
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constructors and gc 



Instance Variable 



We saw an educational video about it once. 
Looks like a pretty brutal ending. I mean, 
when that method hits its ending curly brace, 
the frame is literally blown off the Stack! Now 
that’s gotta hurt. 



I live on the Heap, with the objects. Well, not 
with the objects, actually in an object. The 
object whose state I store. I have to admit life 
can be pretty luxurious on the Heap. A lot of 
us feel guilty, especially around the holidays. 



OK, hypothetically, yes, if I’m an instance 
variable of the Collar and the Collar gets 
GC’d, then the Collar’s instance variables 
would indeed be tossed out like so many pizza 
boxes. But I was told that this almost never 
happens. 



They let us drink ? 



Local Variable 

frame gets to run again. On the one hand, we 
get to be active again. On the other hand, the 
clock starts ticking again on our short lives. 
The more time our method spends running, 
the closer we get to the end of the method. 

We all know what happens then. 

Tell me about it. In computer science they use 
the term popped as in “the frame was popped 
off the Stack”. That makes it sound fun, or 
maybe like an extreme sport. But, well, you 
saw the footage. So why don’t we talk about 
you? I know what my little Stack frame looks 
like, but where do you live? 



But you don’t always live as long as the object 
who declared you, right? Say there’s a Dog 
object with a Collar instance variable. Imagine 
you’re an instance variable of the Collar object, 
maybe a reference to a Buckle or something, 
sitting there all happy inside the Collar object 
who’s all happy inside the Dog object. But... 
what happens if the Dog wants a new Collar, 
or nulls out its Collar instance variable? That 
makes the Collar object eligible for GC. So... 
if you’re an instance variable inside the Collar, 
and the whole Collar is abandoned, what 
happens to you ? 



And you believed it? That’s what they say to 
keep us motivated and productive. But aren’t 
you forgetting something else? What if you’re 
an instance variable inside an object, and that 
object is referenced only by a local \ ariable? If 
I’m the only reference to the object you’re in, 
when I go, you’re coming with me. Like it or 
not, our fates may be connected. So I say we 
forget about all this and go get drunk while 
we still can. Carpe RAM and all that. 
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exercise: Be the Garbage Collector 





BE ih& Garbage Collector 

Which of the lines of code on the right, if added 
to the class on the left at point A, would cause 
exactly one additional object to be eligible for the 
Garbage Collector? (Assume that point A (//call 
more methods) will execute for a long time, giving the 
Garbage Collector time to do its stuff.) 



public class GC { 

public static GC doStuff() { 



GC newGC = new GC ( ) ; 


1 


copyGC = null; 


doStuff2 (newGC) ; 


return newGC; 

} 


2 


gc2 = null; 




3 


newGC = gc3; 


public static void main (String [] args) 


{ 




GC gel; 


4 


gel = null; 


GC gc2 = new GC ( ) ; 


GC gc3 = new GC ( ) ; 


5 


newGC = null; 


GC gc4 = gc3; 


gel = doStuf f ( ) ; 


6 


gc4 = null; 


Q 




7 


gc3 = gc2; 


// call more methods 


} 


8 


gel = gc4; 


public static void doStuff2 (GC copyGC) 


( 9 


gc3 = null; 



GC localGC 



} 
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constructors and gc 




Papular 

OtyecfS 



In this code example, several new objects are created. 
Your challenge is to find the object that is 'most popular', 
i.e.the one that has the most reference variables referring 
to it. Then list how many total references there are for 
that object, and what they are! We'll start by pointing out 
one of the new objects, and its reference variable. 

Good Luck ! 



class Bees { 



Honey [ ] beeHA; 

} 

class Raccoon { 
Kit k; 

Honey rh; 



class Kit { 

Honey kh; 

} 

class Bear { 

Honey hunny; 

} 

public class Honey { 

public static void main (String [] args ) { 

Honey honeyPot = new Honey ( ) ; 

Honey [ ] ha = {honeyPot, honeyPot, honeyPot, honeyPot}; 
Bees bl = new Bees ( ) ; 
bl. beeHA = ha; 

Bear [ ] ba = new Bear[5]; 
for ( int x=0; x < 5; x++) { 
ba[x] = new Bear(); 
ba[x]. hunny = honeyPot; 



} 



} 

Kit k = new Kit( ) ; 
k.kh = honeyPot; 

Raccoon r = new Raccoon () 




Here's a new 




Here's its reference 
variable 'r'. 



r.rh = honeyPot; 
r.k = k; 
k = null; 



} // end of main 



} 
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puzzle: Five Minute Mystery 




Jive-Minute 

Mystery 




“We’ve run the simulation four times, and the main module’s temperature consistently 
drifts out of nominal towards cold”, Sarah said, exasperated. “We installed the new temp-bots last 
week. The readings on the radiator bots, designed to cool the living quarters, seem to be within 
spec, so we’ve focused our analysis on the heat retention bots, the bots that help to warm the quar- 
ters.” Tom sighed, at first it had seemed that nano-technology was going to really put them ahead 
of schedule. Now, with only five weeks left until launch, some of the orbiter’s key life support 
systems were still not passing the simulation gauntlet. 

“What ratios are you simulating?”, Tom asked. 

“Well if I see where you’re going, we already thought of that”, Sarah replied. “Mis- 
sion control will not sign off on critical systems if we run them out of spec. We are 
required to run the v3 radiator bot’s SimUnits in a 2:1 ratio with the v2 radiator’s 
SimUnits”, Sarah continued. “Overall, the ratio of retention bots to radiator bots is 
supposed to run 4:3.” 

“How’s power consumption Sarah?”, Tom asked. Sarah paused, “Well that’s 
another thing, power consumption is running higher than anticipated. We’ve got a team 
tracking that down too, but because the nanos are wireless it’s been hard to isolate the power 
consumption of the radiators from the retention bots.” “Overall power consumption ratios”, Sarah 
continued, “are designed to run 3:2 with the radiators pulling more power from the wireless grid.” 

“OK Sarah”, Tom said “Let’s take a look at some of the simulation initiation code. 

We’ve got to find this problem, and find it quick!” 



import java.util.*; 
class V2Radiator { 

V2Radiator (ArrayList list) { 
for(int x=0; x<5; x++) { 

list . add ( new SimUnit ( "V2Radiator " ) ) ; 

} 

} 

} 

class V3Radiator extends V2Radiator { 
V3Radiator (ArrayList lglist) { 
super ( lglist) ; 
for(int g=0; g<10; g++) { 

lglist . add ( new SimUnit ( "V3Radiator" ) ) ; 

} 

} 

} 

class RetentionBot { 

RetentionBot (ArrayList rlist) { 

rlist . add ( new SimUnit ( "Retention" ) ) ; 

} 

} 
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constructors and gc 



flve^tlnufe 

Mystery 

confirmed... 



public class TestLifeSupportSim { 

public static void main (String [] args ) { 



ArrayList aList = new ArrayList(); 
V2Radiator v2 = new V2Radiator ( aList ) ; 
V3Radiator v3 = new V3Radiator ( aList ) ; 
for(int z=0; z<20; z++) { 



RetentionBot ret = new RetentionBot ( aList ) ; 



} 

} 



} 



class SimUnit { 

String botType; 

SimUnit ( String type) { 
botType = type; 

} 

int powerUse() { 

if ( "Retention" .equals (botType) ) { 
return 2 ; 

} else { 
return 4 ; 



Tom gave the code a quick look and a small smile creeped across his lips. I think Fve 
found the problem Sarah, and I bet I know by what percentage your power usage readings are off 
too! 



What did Tom suspect? How could he guess the power readings errors, and what few 
lines of code could you add to help debug this program? 



} 



} 



} 
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object lifecycle 






Exercise Solutions 



G.C. 



copyGC = null; 


No - this line attempts to access a variable 
that is out of scope. 


gc2 = null; 


OK - gc2 was the only reference variable 
referring to that object. 


newGC = gc3; 


No - another out of scope variable. 


gel = null; 


OK - gel had the only reference because 
newGC is out of scope. 


newGC = null; 


No - newGC is out of scope. 


gc4 = null; 


No - gc3 is still referring to that object. 


gc3 = gc2; 


No - gc4 is still referring to that object. 


gel = gc4; 


OK - Reassigning the only reference to 
that object. 


gc3 = null; 


No - gc4 is still referring to that object. 



papular 

Objects 



It probably wasn't too hard to figure out that the Honey object first referred to by the honeyPot variable is by 
far the most 'popular' object in this class. But maybe it was a little trickier to see that all of the variables that 
point from the code to the Honey object refer to the same object ! There are a total of 1 2 active references to 
this object right before the main( ) method completes. The k.kh variable is valid for a while, but k gets nulled 
at the end. Since r.k still refers to the Kit object, r.k.kh (although never explicity declared), refers to the object! 



public class Honey { 

public static void main (String [] args ) { 




k = null; 

y } // end of main 
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constructors and gc 




Rve^lnitfe Mystery ^Jut^n 

Tom noticed that the constructor for the V2Radiator class took an 
Array List. That meant that every time the VJRadiator constructor was called, 
it passed an ArrayList in its super() call to the V2Radiator constructor. That 
meant that an extra five V2Radiator SimUnits were created. If Tom was right, 
total power use would have been 120, not the 100 that Sarah’s expected ratios 
predicted. 

Since all the Bot classes create SimUnits, writing a constructor for 
the SimUnit class, that printed out a line everytime a SimUnit was created, 
would have quickly highlighted the problem! 
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1 0 numbers and statics 



Numbers Matter 




Do the Math. But there's more to working with numbers than just doing primitive 
arithmetic. You might want to get the absolute value of a number, or round a number, or find 
the larger of two numbers. You might want your numbers to print with exactly two decimal 
places, or you might want to put commas into your large numbers to make them easier to read. 
And what about working with dates? You might want to print dates in a variety of ways, or even 
manipulate dates to say things like, "add three weeks to today's date" And what about parsing 
a String into a number? Or turning a number into a String? You're in luck. The Java API is full of 
handy number-tweaking methods ready and easy to use. But most of them are static, so we'll 
start by learning what it means for a variable or method to be static, including constants in 
Java — static final variables. 
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Math methods 



MATH methods: as close as you'll 
ever get to a global method 



Except there’s no global anything in Java. But think about 
this: what if you have a method whose behavior doesn’t 
depend on an instance variable value. Take the round () 
method in the Math class, for example. It does the same 
thing every time — rounds a floating point number (the 
argument to the method) to the nearest integer. Every 
time. If you had 10,000 instances of class Math, and ran 
the round ( 42 . 2 ) method, you’d get an integer value of 
42 . Every time. In other words, the method acts on the 
argument, but is never affected by an instance variable 
state. The only value that changes the way the round () 
method runs is the argument passed to the method! 

Doesn’t it seem like a waste of perfectly good heap space 
to make an instance of class Math simply to run the 
round () method? And what about oferMath methods 
like min(), which takes two numerical primitives and 
returns the smaller of the two. Or max(). Or abs(), which 
returns the absolute value of a number. 

These methods never use instance variable values. In fact the 
Math class doesn’t have my instance variables. So there’s 
nothing to be gained by making an instance of class 
Math. So guess what? You don’t have to. As a matter of 
fact, you can’t. 



If you try to make an instance of 
class Math: 

Math mathObject = new Math() ; 

You’ll get this error: 



Methods in the Math class 
don’t use any instance 
variable values. And because 
the methods are 'static’, 
you don’t need to have an 
instance of Math. All you 
need is the Math class. 



int x = Math . round (42.2) ; 
int y = Math. min (56 , 12) ; 
int z = Math. abs (-343); 



^ c methods usc 

T ,ab J, es ‘ s ° 

, behdVl< f <Wt *eed lo 

abou * * object 



File Edit Window Help IwasToldThereWouldBeNoMath 



%javac TestMath 

Tes tMath . j ava : 3 : Math ( ) has private 
access in java. lang. Math 

Math mathObject = new Math() ; 

A 

1 error 



^ hi V^r sU “ that ihc AUh 

Construetw is marked pvi vaicl 
".cans you WFi/cp r , te , ' bat 

Math cL to say rr 

to make a new Math object 
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numbers and statics 



The difference between regular 
(non-static) and static methods 

Java is object-oriented, but once in a while you have a special case, 
typically a utility method (like the Math methods), where there is 
no need to have an instance of the class. The keyword static lets 
a method run without any instance of the class. A static method means 
“behavior not dependent on an instance variable, so no instance/object 
is required. Just the class.” 



regular (non-static) method 



static method 



public class Song { vav ., a Ue xaWe a ^ et 

String title; Savior ^ 

public Song (String 
title = t; 



} 

public void play() { 

SoundPlayer player = new SoundPlayer ( ) ; 




public static int min(int a , int b) { 
//returns the lesser of a and b 



} 




Wo <* riaWeS - 

The method W-Jr 
doesn’t tha^ey™ 

instance vaiaWe slate ' 



Math. min (42 , 36) ; 

\ 

Use the Class na«>e, 

than ate We ^' aWe 

Y\dn\C 




Hc WJBCTSII 

h ihls rkh+ti 
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static methods 



Call a static method 
Class name 




.min 



using a 

( 88 , 86 ) ; 



Call a non-static method using a 
reference variable name 




Song t2 = new Song() ; 



t2 . play ( ) ; 



What it means to have a 
class with static methods. 

Often (although not always), a class with static 
methods is not meant to be instantiated. In Chapter 
8 we talked about abstract classes, and how marking 
a class with the abstract modifier makes it 
impossible for anyone to say ‘new’ on that class type. 
In other words, it’s impossible to instantiate an abstract 
class. 

But you can restrict other code from instantiating 
a non-abstract class by marking the constructor 
private. Remember, a method marked private means 
that only code from within the class can invoke 
the method. A constructor marked private means 
essentially the same thing — only code from within 
the class can invoke the constructor. Nobody can 
say ‘new’ from outside the class. That’s how it works 
with the Math class, for example. The constructor 
is private, you cannot make a new instance of Math. 
The compiler knows that your code doesn’t have 
access to that private constructor. 



This does not mean that a class with one or more 
static methods should never be instantiated. In fact, 
every class you put a main() method in is a class with 
a static method in it! 

Typically, you make a main() method so that you 
can launch or test another class, nearly always by 
instantiating a class in main, and then invoking a 
method on that new instance. 

So you’re free to combine static and non-static 
methods in a class, although even a single non-static 
method means there must be some way to make an 
instance of the class. The only ways to get a new 
object are through ‘new’ or deserialization (or 
something called the Java Reflection API that we 
don’t go into) . No other way. But exactly who says new 
can be an interesting question, and one we’ll look at 
a little later in this chapter. 
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numbers and statics 



Static methods can't use non-static 
(instance) variables! 



Static methods run without knowing about any particular 
instance of the static method’s class. And as you saw on 
the previous pages, there might not even be any instances 
of that class. Since a static method is called using the class 
{Math. random ()) as opposed to an instance reference {t 2 . play()), 
a static method can’t refer to any instance variables of the 
class. The static method doesn’t know which instance’s variable 
value to use. 



If you try to compile this code: 



public class Duck { 
private int size; 












public static void main (String [] args) 
System. out .println ("Size of duck is ' 



si**- 



I 



{ 

+ size) ; 



} 

public void setSize(int s) 
size = s; 



ye heap **«*(,„, 
don i know about i- 



If you try to use an 
instance variable from 
inside a static method, 
the compiler thinhs, 

“I don’t know which 
object’s instance variable 
you’re talking about!” 

If you have ten Duck 
objects on the heap, a 
static method doesn’t 
know about any of them. 



} 

public int getSize() { 
return size; 

} 



You’ll get this error: 



|File Edit Window Help Quack 



% javac Duck. java 

Duck. java: 6: non-static variable 
size cannot be referenced from a 
static context 

System .out.println("Size 
of duck is " + size) ; 

A 
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static methods 



Static methods can't use non-static 
metho ds, either! 

What do non-static methods do? They usually use instance 
variable state to affect the behavior of the method. A getName() 
method returns the value of the name variable. Whose name? 
The object used to invoke the getNameQ method. 



This won’t compile: 

public class Duck { 
private int size; 



lz * ^isy\£.c variable ' 



public static void main ( String [] args) { 

System. out .println ("Size is " + getSize()); 




File Edit Window Help Jack-in 



% javac Duck. java 

Duck. java: 6: non-static method 
getSize() cannot be referenced 
from a static context 

System . out . println ( "Size 
of duck is " + getSize()) 




□ w dsV , 

— » 

Make it StiS- 

Roses are red, 

and known to bloom late 

Statics can't see 

instance variable state 
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-tJiereiqreJiP 

Dumb Questions 



What if you try to call a non-static 
method from a static method, but the 
non-static method doesn't use any in- 
stance variables. Will the compiler allow 
that? 

A- 

Jr \ m No. The compiler knows that 
whether you do or do not use instance 
variables in a non-static method, you can. 
And think about the implications... if you 
were allowed to compile a scenario like 
that, then what happens if in the future 
you want to change the implementation 
of that non-static method so that one day 
it does use an instance variable? Or worse, 
what happens if a subclass overrides the 
method and uses an instance variable in 
the overriding version? 



Q? I could swear I've seen code that 
calls a static method using a reference 
variable instead of the class name. 



You can do that, but as your mother 
always told you,"Just because it's legal 
doesn't mean it's good." Although it works 
to call a static method using any instance 
of the class, it makes for misleading (less- 
readable) code. You can say, 

Duck d = new Duck ( ) ; 

String [] s = {}; 
d.main(s) ; 



This code is legal, but the compiler just 
resolves it back to the real class anyway 
("OK, d is of type Duck, and main() is static, 
so I'll call the static main() in class Duck"). 
In other words, using d to invoke main() 
doesn't imply that main() will have any 
special knowledge of the object that d is 
referencing. It's just an alternate way to 
invoke a static method, but the method is 
still static! 
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numbers and statics 



Static variable: 

value is the same for All 
instances of the class 



Imagine you wanted to count how many Duck 
instances are being created while your program is 
running. How would you do it? Maybe an instance 
variable that you increment in the constructor? 



class Duck { 

int duckCount = 0 ; 
public Duck ( ) { 

duckCount++ ; 




J wa s J de hrne 



No, that wouldn’t work because duckCount is an 
instance variable, and starts at 0 for each Duck. You 
could try calling a method in some other class, but 
that’s kludgey. You need a class that’s got only a single 
copy of the variable, and all instances share that one 
copy. 



public class Duck { 

private int size; 
private static int duckCount = 0 ; 




} 



public Duck ( ) { 



duckCount++ ; i ^ ee P 

> ti'bZl: 3 T h ^ 

because ^ 

public void setSize(int s) { 



size = s; 



} 

public int getSize() { 
return size; 

} 
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static variables 




k\d mstanfce ovvC 



s-ta-tid variable^ 
ideCrearw 



kid ihS"tahde "two 



Static variables are stared. 

All instances of ike same 
class stare a single copy ol 
tke static variables. 

instance variables: 1 per instance 
static variables: 1 per class 




4 > 

Brain Bartel 



Earlier in this chapter, we saw that a private 
constructor means that the class can't be instantiated 
from code running outside the class. In other words, 
only code from within the class can make a new 
instance of a class with a private constructor. (There's 
a kind of chicken-and-egg problem here.) 



What if you want to write a class in such a way that 
only ONE instance of it can be created, and anyone 
who wants to use an instance of the class will always 
use that one, single instance? 
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Initializing a static variable 



numbers and statics 



Static variables are initialized when a class is loaded. A class is 
loaded because the JVM decides it’s time to load it. Typically, 
the JVM loads a class because somebody’s trying to make a 
new instance of the class, for the first time, or use a static 
method or variable of the class. As a programmer, you also 
have the option of telling the JVM to load a class, but you’re 
not likely to need to do that. In nearly all cases, you’re better 
off letting the JVM decide when to load the class. 

And there are two guarantees about static initialization: 

Static variables in a class are initialized before any object of that 
class can be created. 



All static variables 
in a class are 
initialized before 
any object of 
that class can be 
created. 



Static variables in a class are initialized before 
of the class runs. 

class Player { 

static int playerCount = 0; 
private String name; 
public Player (String n) { 



ny static method 



The elawrCow-t 1. Wtafafl >*» 

h> smde O is the default value W Statid vaw 
ables jet default values just like instate vaviab es. 



name = n; 
playerCount++ ; 

} 

} 



public class PlayerTestDrive { 

public static void main (String [] args) { 

System. out .println (Player .playerCount) ; 
Player one = new Player ("Tiger Woods") ; 
System. out .println (Player .playerCount) ; 



**“ »***«* ;; STSUr 

Wqa, (U, 0 

boolean 

ob jedt referendcs: „ u || 



} 



V /\ddess a statid vaviable just like a statid 
method — -With the dlass «ame- 



Static variables are initialized when the class is loaded. If you 
don’t explicitly initialize a static variable (by assigning it a 
value at the time you declare it) , it gets a default value, so int 
variables are initialized to zero, which means we didn’t need 
to explicitly say “playerCount = 0”. Declaring, but not initial- 
izing, a static variable means the static variable will get the de- 
fault value for that variable type, in exactly the same way that 
instance variables are given default values when declared. 



File Edit Window Help What? 



java PlayerTestDrive 
^ bc-fovc an y ms-tahdcs av-e r*ade| 






^r^objed-fc is c, eaied 
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static final constants 



static final variables are constants 



A variable marked finalmeans that — once initialized — it can 
never change. In other words, the value of the static final variable 
will stay the same as long as the class is loaded. Look up Math. PI 
in the API, and you’ll find: 

public static final double PI = 3.141592653589793; 

The variable is marked public so that any code can access it. 

The variable is marked static so that you don’t need an 
instance of class Math (which, remember, you’re not allowed to 
create). 

The variable is marked final because PI doesn’t change (as far as 
Java is concerned). 

There is no other way to designate a variable as a constant, but 
there is a naming convention that helps you to recognize one. 

Constant variable names should be in all caps! 



of code that runs when a 
class is loaded, before any 
other code can use the 
class, so it’s a great place 
to initialize a static final 
variable, 
class Foo { 



final static int x; 



static { 
x = 42; 

} 

} 



Initialize a final static variable: 

(j) At the time you declare it: 



public class Foo { 

public static final int FOO_X = 25; 

} 



OR 









© In a static initializer: 



public class Bar { 

public static final double BARJSIGN; 



static { 




BAR_SIGN = (double) Math . random ( ) 



} 

,s loaded [+T * s So °* as -Au ,1 

jr a -H J be+oi re am 1 i C ^lass 
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If you don't give a value to a final variable 
in one of those two places: 

public class Bar { 

public static final double BAR_SIGN; 

} h ° Static*/ 



The compiler will catch it: 

|Fik^dl^Tvindo^TeT[^aciHr^^^^^^^^ 



% javac Bar. java 

Bar. java: 1: variable BAR_SIGN 
might not have been initialized 

1 error 
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final isn't just for static 
variables... 



numbers and statics 



You can use the keyword final to modify non- 
static variables too, including instance variables, 
local variables, and even method parameters. In 
each case, it means the same thing: the value can’t 
be changed. But you can also use final to stop 
someone from overriding a method or making a 
subclass. 



non-static final variables 



class Foof { 

final int size = 
final int whuffie 



3 ^ . now you Can't Change siz£ 



Foof () { cc • 

whuffie = 42 ; < c -- . now you dan Z dhan^C wnu-r id 

} 

void doStuf f (final int x) { 

// you can't change x 

} 



A final variable means you 
can’t change its value. 

A final method means you 
can’t override the method. 

A final class means you 
can’t extend the class (i.e. 
you can’t make a subclass). 



void doMore ( ) { 

final int z = 7 ; 

// you can't change z 

} 

} 



final method 

class Poof { 

final void calcWhuf fie ( ) { 

// important things 

// that must never be overridden 

} 

} 



final Class 

final class MyMostPerfectClass { 
// cannot be extended 

} 
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static and final 



fJiereiareriP 

Dunib Questions 



O: A static method can't access a 
non-static variable. But can a non-static 
method access a static variable? 



A. 

M.* Of course. A non-static method in a 
class can always call a static method in the 
class or access a static variable of the class. 



Why would I want to make a class 
final? Doesn't that defeat the whole 
purpose of 00? 

A- 

M.* Yes and no. A typical reason for 
making a class final is for security. You 
can't, for example, make a subclass of the 
String class. Imagine the havoc if someone 
extended the String class and substituted 
their own String subclass objects, 
polymorphically, where String objects 
are expected. If you need to count on a 
particular implementation of the methods 
in a class, make the class final. 



% Isn't it redundant to have to mark 
the methods final if the class is final? 



A* 

Jr \ m If the class is final, you don't need to 
mark the methods final. Think about it — if 
a class is final it can never be subclassed, 
so none of the methods can ever be 
overridden. 

On the other hand, if you do want to allow 
others to extend your class, and you want 
them to be able to override some, but not 
all, of the methods, then don't mark the 
class final but go in and selectively mark 
specific methods as final. A final method 
means that a subclass can't override that 
particular method. 
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■ A static method should be called using the class 
name rather than an object reference variable: 

Math . random ( ) vs. myFoo . go ( ) 

■ A static method can be invoked without any instances 
of the method’s class on the heap. 

■ A static method is good for a utility method that does 
not (and will never) depend on a particular instance 
variable value. 

■ A static method is not associated with a particular 
instance— only the class— so it cannot access any 
instance variable values of its class. It wouldn’t know 
which instance’s values to use. 

■ A static method cannot access a non-static method, 
since non-static methods are usually associated with 
instance variable state. 

■ If you have a class with only static methods, and you 
do not want the class to be instantiated, you can mark 
the constructor private. 

■ A static variable is a variable shared by all members 
of a given class. There is only one copy of a static 
variable in a class, rather than one copy per each 
individual instance for instance variables. 

■ A static method can access a static variable. 

■ To make a constant in Java, mark a variable as both 
static and final. 

■ A final static variable must be assigned a value either 
at the time it is declared, or in a static initializer. 

static { 

DOG_CODE = 420; 

} 

■ The naming convention for constants (final static 
variables) is to make the name all uppercase. 

■ A final variable value cannot be changed once it has 
been assigned. 

■ Assigning a value to a final instance variable must be 
either at the time it is declared, or in the constructor. 

■ A final method cannot be overridden. 

■ A final class cannot be extended (subclassed). 
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numbers and statics 




What’s Legal? 

Given everything you've just 
learned about static and final, 
which of these would compile? 



KEEP 




RIGHT 



© 



public class Foo { 
static int x; 



public void go() { 

System. out .pr in tin (x) ; 

} 



( 2 ) public class Foo2 
int x; 



public static void go() { 
System. out .pr in tin (x) ; 

} 



© 



public class Foo4 { 

static final int x = 12 ; 



public void go() { 

System. out .print In (x) ; 

} 



© 



public class Foo5 { 

static final int x = 12 ; 



public void go (final int x) { 
System. out .print In (x) ; 

} 



© 



public class Foo3 
final int x; 



{ 



public void go ( ) { 

System. out .pr in tin (x) ; 

} 



© 



public class F 006 
int x = 12 ; 



{ 



public static void go (final int x) { 
System. out .println (x) ; 

} 
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Math methods 



Math methods 



Now that we know how static 
methods work, let’s look 
at some static methods in 
class Math. This isn’t all of 
them, just the highlights. 
Check your API for the rest 
including sqrt(), tan(), ceil(), 
floor (), and asin(). 



Math.random() 

Returns a double between 0.0 through (but 

not including) 1.0. 

double r 1 = Math . random ( ) ; 

int r2 = (int) (Math . random ( ) * 5); 



Math.abs() 

Returns a double that is the absolute value of 
the argument. The method is overloaded, so 
if you pass it an int it returns an int. Pass it a 
double it returns a double. 



int x = Math . abs (-240) ; // returns 240 

double d = Math. abs (240 . 45) ; // returns 240.45 



Math.round() 

Returns an int or a long (depending on 
whether the argument is a float or a double) 
rounded to the nearest integer value. 



int x = Math . round (-24 . 8f) ; // returns -25 
int y = Math . round (24 . 45f) ; // returns 24 



Math.min() 



t 



po,nt ,iw ** *s- ed 

to be doubles unless y ou ac |d ^ 



Returns a value that is the minimum of the 



two arguments. The method is overloaded to 
take ints, longs, floats, or doubles. 



int x = Math. min (24 ,240) ; // returns 24 

double y = Math .min (90876 . 5 , 90876.49); // returns 90876.49 



Math.max() 

Returns a value that is the maximum of the 

two arguments. The method is overloaded to 

take ints, longs, floats, or doubles. 

int x = Math .max (24 , 240) ; // returns 240 

double y = Math .max (90876 . 5 , 90876.49); // returns 90876.5 
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numbers and statics 



Wrapping a primitive 

Sometimes you want to treat a primitive like 
an object. For example, in all versions of Java 
prior to 5 . 0 , you cannot put a primitive directly 
into a collection like ArrayList or HashMap: 

int x = 32 ; 

ArrayList list = new ArrayList () ; 
list. add (x) ; ^ 

unless youVe 
s no add(ivrt) 
t! (AvvayUs-. 

i ve-feventes, primitives../ 

There’s a wrapper class for every primitive type, 
and since the wrapper classes are in the java, 
lang package, you don’t need to import them. 

You can recognize wrapper classes because 
each one is named after the primitive type it 
wraps, but with the first letter capitalized to 
follow the class naming convention. 

Oh yeah, for reasons absolutely nobody on the 
planet is certain of, the API designers decided 
not to map the names exactly from primitive 
type to class type. You’ll see what we mean: 



This won't wovk^ 
arcatcr!! There 
that takes an in 
that take objefc 



usinft Java 5.0 or 
method in ArrayList 
f onlv has addO methods 



Boolean 
Character 
Byte 
Short 
Integer 
Long 
Float 




VVatfch out 1 The names arent 
mapped e*adtly to the frWtiw 
types. The tlass names are +«Hy 
spelled out- 



Double 

£jWe the primitive to the 
wrapper tonsWtor. Thats it- 

wrapping a value 

int i = 288; 

Integer iWrap = new Integer (i); 

All the wrappers work 
like this. Boolean has a 



unwrapping a value ^ Kas a tha^alueO, ett 

int unwrapped = iWrap . intValue ( ) ; 



^ boolean\/alueO, Character 




primitive 




Wken you need to treat 
a primitive like an okject, 
wrap it. If you’re using any 
version of Java kefore 5.0, 
you’ll do tkis wken you 
need to store a primitive 
value inside a collection like 
ArrayList or HaskMap. 




Note: the picture at the top is a chocolate in a foil wrapper. Get 
it? Wrapper? Some people think it looks like a baked potato, but 
that works too. 
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static methods 




This is stupid. You mean I can't 
just make an ArrayList of ints??? I 
have to wrap every single trickin' one in a new 
Integer object, then unwrap it when I try 
to access that value in the ArrayList? 
That's a waste of time and an error 
waiting to happen... 



before Java 5.0, YOU had to do the work... 

She’s right. In all versions of Java prior to 5 . 0 , primitives were primitives 
and object references were object references, and they were NEVER 
treated interchangeably. It was always up to you, the programmer, to do 
the wrapping and unwrapping. There was no way to pass a primitive to a 
method expecting an object reference, and no way to assign the result of a 
method returning an object reference directly to a primitive variable — even 
when the returned reference is to an Integer and the primitive variable is 
an int. There was simply no relationship between an Integer and an int, 
other than the fact that Integer has an instance variable of type int (to hold 
the primitive the Integer wraps) . All the work was up to you. 



An ArrayList of primitive ints 

Without autoboxing (Java versions before 5.0) 

» L C 5.0 VOVA toM KO*t 

public void doNumsOldWay ( ) ( ***'*£$? ^ ^ ^ 



the 

ArrayList listOf Numbers = new ArrayList () ; , 

. ,, dd tj* ? vWrtWe ? ^ tfce tet. 

listOfNumbers . add (new Integer (3) ) ; — ' ow ta> L V£ -to wva? it m 3,1 l*'tey v ’ * 1,rS 



SO you 



Integer one = (Integer) listOfNumbers . get (0) ; out as 

obvettwir* 4 **."* 1 

int intOne = one . intValue ( ) ; ^ Object to a* mtcyv- 



Final!' 









C3CV-. 
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numbers and statics 



Autoboxing: blurring the line 
between primitive and object 

The autoboxing feature added to Java 5.0 does 
the conversion from primitive to wrapper object 
automatically! 

Let’s see what happens when we want to make an 
ArrayList to hold ints. 



An ArrayList of primitive ints 



With autoboxing (Java versions 5.0 or greater) 



public void doNumsNewWay ( ) { 

ArrayList<Integer> listOfNumbers 



Make a« 

4 / 

new ArrayList<Integer> ( ) ; 



listOfNumbers . add (3) ; Jus-fc add j -£/ 

int num = listOfNumbers . get (0) ; 

£ >-«**•* ti 



Although there is NOT a method in ArrayList 
-for add(int); the domyiler does all the wrapping 
(bo%ing) -for you. |n other words, there really IS 
an Integer object stored in the ArrayList, but 
you get to w pretend w that the ArrayList takes 
ints. (>/ou dan add both ints and Integers to an 
Arr ay List< I nteger > . ) 



0? Why not declare an ArrayList<int> if you want to 
hold ints? 



A* 

Jr \ m Because .. .you can't. Remember, the rule for generic 
types is that you can specify only class or interface types, not 
primitives. So ArrayList<int> will not compile. But as you can 
see from the code above, it doesn't really matter, since the 
compiler lets you put ints into the ArrayList<lnteger>. In fact, 
there's really no way to prevent you from putting primitives 
into an ArrayList where the type of the list is the type of that 
primitive's wrapper, if you're using a Java 5.0-compliant com- 
piler, since autoboxing will happen automatically. So, you can 
put boolean primitives in an ArrayList<Boolean> and chars 
into an ArrayList<Character>. 
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static methods 



Autoboxmg works almost everywhere 

Autoboxing lets you do more than just the obvious wrapping and 
unwrapping to use primitives in a collection... it also lets you use 
either a primitive or its wrapper type virtually anywhere one or the 
other is expected. Think about that! 



Fun with autoboxing 



Method arguments 

If a method takes a wrapper type, you 
can pass a reference to a wrapper or 
a primitive of the matching type. And 
of course the reverse is true— if a 
method takes a primitive, you can 
pass in either a compatible primitive 
or a reference to a wrapper of that 
primitive type. 




void takeNumber (Integer i) { } 



Return values 

If a method declares a primitive 
return type, you can return either a 
compatible primitive or a reference 
to the wrapper of that primitive type. 
And if a method declares a wrapper 
return type, you can return either a 
reference to the wrapper type or a 
primitive of the matching type. 



int giveNumber() { 



return x; 




Boolean expressions 

Any place a boolean value is expected, 
you can use either an expression that 
evaluates to a boolean (4 > 2), or a 
primitive boolean, or a reference to a 
Boolean wrapper. 




if (bool) { 



System. out .println ("true") ; 

} 
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numbers and statics 



Operations on numbers 

This is probably the strangest one— yes, you 
can now use a wrapper type as an operand 
in operations where the primitive type is 
expected. That means you can apply, say, 
the increment operator against a reference 
to an Integer object! 

But don't worry— this is just a compiler trick. 
The language wasn't modified to make the 
operators work on objects; the compiler 
simply converts the object to its primitive 
type before the operation. It sure looks 
weird, though. 

Integer i = new Integer(42); 
i++; 

And that means you can also do things like: 

Integer j = new Integer(5); 

Integer k = j + 3; 




i++; 



Assignments 

You can assign either a wrapper or primitive 
to a variable declared as a matching wrapper 
or primitive. For example, a primitive int 
variable can be assigned to an Integer 
reference variable, and vice-versa— a 
reference to an Integer object can be 
assigned to a variable declared as an int 
primitive. 





Will this code compile? Will it run? If it runs, 
what will it do? 

Take your time and think about this one; it 
brings up an implication of autoboxing that 
we didn’t talk about. 

You’ll have to go to your compiler to find 
the answers. (Yes, we’re forcing you to 
experiment, for your own good of course.) 



public class TestBox { 



Integer i; 
int j ; 

public static void main (String [] args) { 
TestBox t = new TestBox () ; 
t . go ( ) ; 

} 



public void go() { 
j=i; 

System. out .println (j) ; 
System. out .println (i) ; 

} 

} 
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wrapper methods 



Pot wait! There's more! Wrappers 
have static utility methods too! 

Besides aedng like a normal class, the wrappers have a 
bunch of really useful static methods. We’ve used one in 
this book before — Integer.parselnt(). 

The parse methods take a String and give you back a 
primitive value. 



Converting a String to a ?vo y em io ya<rse 

primitive value is easy: m-to 2- 

String s = " 2 "; 

int x = Integer .par selnt (s) ; 

double d = Double .parseDouble ("420.24"); 



boolean b = new Boolean ("true") . booleanValue ( ) ; 




But if you try to do this: 

String t = "two"; 

int y = Integer .parselnt (t) 



/~~~ Uh—oh. This Compiles jus-t -fine, bu-t 
\L at v-Uhtime it blows up. Anything 
; that ca*-t be parsed as a number 
will cause a Wumbev-FovmatE^ceptioh 



You’ll get a runtime exception: 



|File Edit Window Help Clue 



% java Wrappers 

Exception in thread "main" 

java . lang . Numbe r Forma tExcept ion : two 

at java . lang . Integer . parselnt ( Integer . java : 40 9 ) 

at java . lang . Integer . parselnt ( Integer . java : 458 ) 

at Wrappers .main (Wrappers . j ava : 9 ) 



Every method or 
constructor that parses 
a String can throw a 
NumberFor mat Exception. 
It’s a runtime exception, 
so you don’t have to 
handle or declare it. 

But you might want to. 

(We’ll talk about Exceptions in the 
next chapter.) 
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numbers and statics 



And now in reverse... turning a 
primitive number into a String 



There are several ways to turn a number into a String. 
The easiest is to simply concatenate the number to an 
existing String. 



loaded 



double d = 42.5; 
String doublestring = 



n u 4- We '+’ oyevatov is o*evioaac« 



lC y '-,i or added 

tcuab”**- (EL 



ISS poles' SVm^iid. 



double d = 42.5; 

String doublestring = Double . toString (d) ; 
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number formatting 



Number formatting 

In Java, formatting numbers and dates doesn’t have to be coupled with I/O. Think 
about it. One of the most typical ways to display numbers to a user is through a 
GUI. You put Strings into a scrolling text area, or maybe a table. If formatting was 
built only into print statements, you’d never be able to format a number into a nice 
String to display in a GUI. Before Java 5 . 0 , most formatting was handled through 
classes in the java, text package that we won’t even look at in this version of the 
book, now that things have changed. 

In Java 5 . 0 , the Java team added more powerful and flexible formatting through a 
Formatter class in java.util. But you don’t need to create and call methods on the 
Formatter class yourself, because Java 5.0 added convenience methods to some of 
the I/O classes (including printf()) and the String class. So it’s a simple matter of 
calling a static String.format() method and passing it the thing you want formatted 
along with formatting instructions. 

Of course, you do have to know how to supply the formatting instructions, and 
that takes a little effort unless you’re familiar with the printf() function in C/ C++. 
Fortunately, even if you don’t know printf() you can simply follow recipes for the 
most basic things (that we’re showing in this chapter) . But you will want to learn 
how to format if you want to mix and match to get anythingyou want. 

We’ll start here with a basic example, then look at how it works. (Note: we’ll revisit 
formatting again in the I/O chapter.) 



Formatting a number to use commas 

public class TestFormats { 

public static void main (String [] args) { 



tv* / e 



C 



I he vw N 



string s = String. format ("% , d" , 1000000000); 

System. out .print In (s ) ; 



Hovj 



1 , 000 , 000,000 



t 

We 9ei Un ' n ' as ,*lo iu c 



io (o r nai a* 

RcmnCmn be\r, ^ j , ** ,S ** »*rfc value). 

fin* -<tWI 
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numbers and statics 



Formatting deconstructed... 

At the most basic level, formatting consists of two main parts 
(there is more, but we’ll start with this to keep it cleaner): 



© 



Formatting instructions 

You use special format specifiers that describe how 
the argument should be formatted. 




The argument to be formatted. 

Although there can be more than one argument, well 
start with just one. The argument type can’t be just 
anything... it has to be something that can be formatted 
using the format specifiers in the formatting instructions. 
For example, if your formatting instructions specify a 
floating point number, you can’t pass in a Dog or even a 
String that looks like a floating point number. 



po ‘tV' s " “this. 

© © 

format ("% , d", 1000000000); 



T 



Use these instructions... on this argument. 



>adi caveWty! 



What do these instructions actually say? 

“Take the second argument to this method, and 
format it as a decimal integer and insert commas.” 

How do they say that? 

On the next page we’ll look in more detail at what the syntax “%, 
d” actually means, but for starters, any time you see the percent 
sign (%) in a format String (which is always the first argument 
to a format() method), think of it as representing a variable, 
and the variable is the other argument to the method. The rest 
of the characters after the percent sign describe the formatting 
instructions for the argument. 
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the formatO method 



The percent i%) says, "insert argument here" 

(and format it using these instructions) 



The first argument to a format () method is called the format String, and it 
can actually include characters that you just want printed as-is, without extra 
formatting. When you see the % sign, though, think of the percent sign as a 
variable that represents the other argument to the method. 



w •'I'cui-ners 

Character! to mtWde in *etehd I a*Wh£ i a ihe 

tV>e trnal vetwy-ne method (the Kucher). 

•fvoim W^a-tO. 



the second aryment is . 

oirr^at'tcd dhd ihscv-tcd W ,r 3 Ur> ' Ch 't "to be 

T vL ' 

format("I have %.2f bugs to fix.", 476578.09876); 







I have 476578.10 bugs to fix. 






The “%” sign tells the formatter to insert the other method argument (the 
second argument to format (), the number) here, AND format it using the 
“. 2 f” characters after the percent sign. Then the rest of the format String, 
“bugs to fix”, is added to the final output. 



Adding a comma 

format ("I have %,.2f bugs to fix.", 476578.09876); 



I have 476,578.10 bugs to fix. 






anting the Wat instvwttio 
&on> "%.tV to %,-2-t , xe got a 
domma m the Watted Mmber- 
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numbers and statics 




But how does it even KNOW 
where the instructions end and the 
rest of the characters begin? How come 
it doesn't print out the "f" in "%.2f"? Or 
the "2"? How does it know that the .2f 
was part of the instructions and NOT^ 
part of the String? 



The format String uses its 
own little language syntax 

You obviously can’t put just anything after the “%” 
sign. The syntax for what goes after the percent 
sign follows very specific rules, and describes 
how to format the argument that gets inserted at 
that point in the result (formatted) String. 

You’ve already seen two examples: 

%, d means “insert commas and format the 
number as a decimal integer.” 

and 



%.2f means “format the number as a floating 
point with a precision of two decimal places.” 

and 



%,.2f means “insert commas and format the 
number as a floating point with a precision of 
two decimal places.” 

The real question is really, “How do I know what 
to put after the percent sign to get it to do what 
I want?” And that includes knowing the symbols 
(like “d” for decimal and “f” for floating point) 
as well as the order in which the instructions 
must be placed following the percent sign. For 
example, if you put the comma after the “d” like 
this: “%d,” instead of “%,d” it won’t work! 

Or will it? What do you think this will do: 



String. format ("I have %.2f, bugs to fix.", 476578.09876); 

(We’ll answer that on the next page.) 
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format specifier 



The format specifier 

Everything after the percent sign up to and including the type indicator (like 
“d” or “f”) are part of the formatting instructions. After the type indicator, the 
formatter assumes the next set of characters are meant to be part of the output 
String, until or unless it hits another percent (%) sign. Hmmmm... is that even 
possible? Can you have more than one formatted argument variable? Put that 
thought on hold for right now; we’ll come back to it in a few minutes. For now, 
let’s look at the syntax for the format specifiers — the things that go after the 
percent (%) sign and describe how the argument should be formatted. 

A format specifier can have up to five different parts (not 
including the Everything in brackets [ ] below is optional, so 

only the percent (%) and the type are required. But the order is 
also mandatory, so any parts you DO use must go in this order. 



% [argument number] [flags] [width] [. precision] type 



, J 

wyuatofhis later... 

't lets you say WHICH 

*C7 M °;ir y 



r 



Tkese a<re $<*, 

io— as, OV 

„ e uatw e *•»*>«■*'» 

V ave*>^eses, <* 

lake ike 

justed- 



This defines -the 
MINIMUM number 

of characters that 
will be used- That’s 
•^minimum^ ^ot 
TOTAL- If the number 
is longer than the 
width, it’ll still be used 
in full, but if it’s less 
than the width, it’ll be 
padded with zeroes. 



You already know 
tWis o»e-<i def ines 
ike yvetision- In 
oikev words, ii 
sets ike numkev 
of detin>al ?lates- 
Pont WjA* 
mtlude ike 
ikeve- 



\ 



in 



Jy ye is mandatory 
(see ike ne*t 
and will usually be 
"d” fon a detwal 
mie^ev or f 
a floating ?®'nt 

number- 



% [argument number] [flags] [width] [. precision] type 




"T. . « r 9 u *eht number 
the other ? \eus art there 
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numbers and statics 



The only required specifier is for TYPE 

Although type is the only required specifier, remember that if you do put 
in anything else, type must always come last! There are more than a dozen 
different type modifiers (not including dates and times; they have their own 
set), but most of the time you’ll probably use %d (decimal) or %f (floating 
point) . And typically you’ll combine %f with a precision indicator to set the 
number of decimal places you want in your output. 



The TYPE is mandatory, everything else is optional. 



%d 



decimal 

format ("%d" 



42); 



The argument must be compatible with an int, so that means 
only byte, short, int, and char (or their wrapper types). 



%f 



floating point 

format ("%.3f", 42.000000) ; 



42.000 



, towWed the -f 
^ a precision indicator 
- AeA up With 



The argument must be of a floating point type, so that 
means only a float or double (primitive or wrapper) as well 
as something called BigDecimal (which we don’t look at in 
this book) . 



You must include a 
type in your format 
instructions, and if you 
specify tkingfs besides 
type, the type must 
always come last. 

Most of the time, 
you’ll probably format 
numbers using either 
”d” for decimal or ”f ” 
for floating point. 



%x hexadecimal 

format ("%x", 42); 



2a 



The argument must be a byte, short, int, long (including 
both primitive and wrapper types) , and Biglnteger. 



%c character 

TV>e 

The argument must be a byte, short, char, or int (including 
both primitive and wrapper types) . 
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format arguments 



What happens if I have more than one argument? 



Imagine you want a String that looks like this: 
“The rank is 20,456,654 out of 100,567,890.24” 



But the numbers are coming from variables. What do you do? You simply add two 
arguments after the format String (first argument), so that means your call to format() 
will have three arguments instead of two. And inside that first argument (the format 
String), you’ll have two different format specifiers (two things that start with “%”). The 
first format specifier will insert the second argument to the method, and the second 
format specifier will insert the third argument to the method. In other words, the 
variable insertions in the format String use the order in which the other arguments are 
passed into the format () method. 



int one = 20456654; 

double two = 100567890.248907; 

String s = String . format ( "The rank is 




The rank is 20,456,654 out of 100,567,890.25 



I/Ve added domras -to bo-tb variables, 
arvd v-es-tvid-ted -tbe -floating poin-t 
numbev (-the sedond variable) io i wo 
dedir*al plades. 






As you’ll see when we get to date formatting, you might actually want to apply different 
formatting specifiers to the same argument. That’s probably hard to imagine until you 
see how date formatting (as opposed to the number formating we’ve been doing) works. 
Just know that in a minute, you’ll see how to be more specific about which format 
specifiers are applied to which arguments. 

% Um, there's something REALLY strange going on here. Just how many arguments can I 
pass? I mean, how many overloaded format!) methods are IN the String class? So, what happens 
if I want to pass, say, ten different arguments to be formatted for a single output String? 

A- 

- r A- Good catch. Yes, there is something strange (or at least new and different) going on, and 
no there are not a bunch of overloaded formatO methods to take a different number of possible 
arguments. In order to support this new formatting (printf-like) API in Java, the language needed 
another new feature — variable argument lists (called varargs for short). We'll talk about varargs 
only in the appendix because outside of formatting, you probably won't use them much in a well- 
designed system. 
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numbers and statics 



So much for numbers, what about dates? 

Imagine you want a String that looks like this: “Sunday, Nov 28 2004 ” 

Nothing special there, you say? Well, imagine that all you have to start with is a variable 
of type Date — A Java class that can represent a timestamp, and now you want to take that 
object (as opposed to a number) and send it through the formatter. 

The main difference between number and date formatting is that date formats use a 
two-character type that starts with “t” (as opposed to the single character “f ’ or “d”, for 
example). The examples below should give you a good idea of how it works: 

The complete date and time %tc 

String . format new Date ( ) ) ; 



Sun Nov 28 14:52:41 MST 2004 



Just the time %tr 

String . format new Date ( ) ) ; 



03:01:47 PM 



Day of the week, month and day 



%tA %tB %td 



There isn’t a single format specifier that will do exactly what we 
want, so we have to combine three of them for day of the week 
(%tA), month (%tB), and day of the month (%td). 

Date today = new Date(); 

String . format ("%tA, %tB %td", today, today, today) 

The domma is nof part o( the -formatting... it's 
just the dhavactev we want printed a-fter the 
first inserted -formatted argument- 



womds, th e %i A .f, ' h *&«• 



Sunday, November 28 



Same as above, but without duplicating the arguments %tA %tB %td 



Date today = new Date ( ) ; 

String . format ("%tA, %<tB %<td" , today) ; 

Vou dan think o( this as kind o( like dalling three 
different getter methods on the Date objedt, to 
get three di-f-ferent piedes o-f data -f rom it- 



The angle-bradket w <" is just another 
j;lag in the spedi-fier that tells the 
formatter to ' 'use the previous argument 
again." So it saves you f rom repeating the 
arguments, and instead you -format the 
same argument three dif -ferent ways. 
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manipulating dates 




/ Let's see... how many work 
days will there be if the 
project starts on Feb 27th and 
ends on August 5th? 



You need to do more with dates than just get 
today’s date. You need your programs to adjust 
dates, find elapsed times, prioritize schedules, 
heck, make schedules. You need industrial 
strength date manipulation capabilities. 

You could make your own date routines of 
course... (and don’t forget about leap years!) 
And, ouch, those occasional, pesky leap- 
seconds. Wow, this could get complicated. The 
good news is that the Java API is rich with 
classes that can help you manipulate dates. 
Sometimes it feels a little too rich... 
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numbers and statics 



Moving backward and forward in time 



Let’s say your company’s work schedule is Monday through Friday. 
You’ve been assigned the task of figuring out the last work day in 
each calendar month this year... 

It seems that java.util.Date is actually... out of date 

Earlier we used java.util.Date to find today’s date, so it seems 
logical that this class would be a good place to start looking for 
some handy date manipulation capabilities, but when you check 
out the API you’ll find that most of Date’s methods have been 
deprecated! 

The Date class is still great for getting a “time stamp” — an object 
that represents the current date and time, so use it when you want 
to say, “give me NOW”. 

The good news is that the API recommends java.util.Calendar 
instead, so let’s take a look: 



For a time-stamp ol "now”, 
use Date. But lor every tiling' 
else, use Calendar. 



Use java.util.Calendar for your date manipulation 

The designers of the Calendar API wanted to think globally, 
literally. The basic idea is that when you want to work with dates, 
you ask for a Calendar (through a static method of the Calendar 
class that you’ll see on the next page), and the JVM hands you back 
an instance of a concrete subclass of Calendar. (Calendar is actually 
an abstract class, so you’re always working with a concrete subclass.) 

More interesting, though, is that the kind of calendar you get 
back will be appropriate for your locale. Much of the world uses the 
Gregorian calendar, but if you’re in an area that doesn’t use a 
Gregorian calendar you can get Java libraries to handle other 
calendars such as Buddhist, or Islamic or Japanese. 

The standard Java API ships with java.util.GregorianCalendar, so 
that’s what we’ll be using here. For the most part, though, you 
don’t even have to think about the kind of Calendar subclass you’re 
using, and instead focus only on the methods of the Calendar class. 
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getting a Calendar 



(retting an object that extends Calendar 

How in the world do you get an “instance” of an abstract class? 

Well you don’t of course, this won’t work: 



This WON’T work: 

Calendar cal = new Calendar ( ) ; 



The dompilev- wor/i alloy/ this j 



Instead, use the static “getlnstance()” method: 

Calendar cal = Calendar . getlnstance () ; 

Wait a minute. 

If you can't make an 
instance of the Calendar 
class, what exactly are you 
assigning to that Calendar 
q \ reference? 



This syntax should look -familiair at this 
point — y/eVe invoking a statid method- 




You can’t get an instance of Calendar, 
but you can can get an instance of a 
concrete Calendar subclass. 

Obviously you can’t get an instance of Calendar, because 
Calendar is abstract. But you’re still free to call static methods 
on Calendar, since static methods are called on the class, 
rather than on a particular instance. So you call the static 
getlnstance () on Calendar and it gives you back... an instance 
of a concrete subclass. Something that extends Calendar 
(which means it can be polymorphically assigned to Calendar) 
and which — by contract — can respond to the methods of class 
Calendar. 

In most of the world, and by default for most versions of Java, 
you’ll be getting back a java.util.GregorianCalendar instance. 
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numbers and statics 



Working with Calendar objects 

There are several key concepts you’ll need to understand in 

order to work with Calendar objects: 

■ Fields hold state - A Calendar object has many fields that are used to 
represent aspects of its ultimate state, its date and time. For instance, you 
can get and set a Calendar’s year or month. 

■ Dates and Times can be incremented - The Calendar class has methods that 
allow you to add and subtract values from various fields, for example “add 
one to the month”, or “subtract three years”. 

■ Dates and Times can be represented in milliseconds - The Calendar class 
lets you convert your dates into and out of a millisecond representation. 
(Specifically, the number of milliseconds that have occured since January 
1st, 1970.) This allows you to perform precise calculations such as “elapsed 
time between two times” or “add 63 hours and 23 minutes and 12 seconds 
to this time”. 



An example of working with a Calendar object: . 0 at \ C) ^' 

Oa 1) ^ ^ 

Calendar c = Calendar . getlnstance () ; ^ y*onth vS z£c °^°^ 

c.set(2004,0,7,15,40); ^ ° to a H * 

long dayl = c . getTimelnMillis () ; 4c ^ amount o£ 



dayl += 1000 * 60 * 60; 

c. setTimelnMillis (dayl) ; 



^dd a* hours worth o£ millis, then update the time. 

— (Not.de the tt +- w , its like day I - dayl + •••)• 



System . out . println ( "new hour " + c . get (c . HOUR_OF_DAY) 
c . add ( c . DATE , 35); ^ 



System . out . println ( "add 35 days 

c. roll (c. DATE, 35); 



+ c . getTime ( ) 



Add 35 days to the date, which 
should move us into February. 



System . out . println ( "roll 35 days 

c . set (c . DATE , 1); ^ 



+ c. getTime (); 



System. out .println ("set to 1 " + c. getTime () 



M W days onto this date. This 
Volls” the date ahead V? days, but 
DOBS HOT dhanje the month l 

do, "9 ^?I?th^da^T e ' ^ 



File Edit Window Help Time-Flies 



new hour 16 

add 35 days Wed Feb 11 16:40:41 MST 2004 
roll 35 days Tue Feb 17 16:40:41 MST 2004 
set to 1 Sun Feb 01 16:40:41 MST 2004 



This output dontirms how millis, 
add, roll, and set work. 
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Calendar API 



Highlights of the Calendar API 

We just worked through using a few of the fields and 
methods in the Calendar class. This is a big API, so 
we’re showing only a few of the most common fields 
and methods that you’ll use. Once you get a few of 
these it should be pretty easy to bend the rest of the 
this API to your will. 



Key Calendar Methods 



adddnt field, int amount) 

Adds or subtracts time from the calendar s field. 

get(int field) 

Returns the value of the given calendar field. 

getlnstanceO 

Returns a Calendar, you can specify a locale. 

getTimelnMillisO 

Returns this Calendar's time in millis, as a long. 

rolKint field, boolean up) 

Adds or subtracts time without changing larger fields 

set(int field, int value) 

Sets the value of a given Calendar field. 

set(year, month, day, hour, minute) (all ints) 

A common variety of set to set a complete time. 

setTimelnMillisdong millis) 

Sets a Calendar's time based on a long milli-time. 

II more... 



Key Ca lendar Fields 

DATE / DAY_OF_MONTH 

Get /set the day of month 

HOUR / HOUR _OF_DAY 

Get / set the 12 hour or 24 hour value 

millisecond 

Get /set the milliseconds. 

minute 

Get /set the minute. 

month 

Get /set the month. 

year 

Get / set the year. 

ZONE_OFFSET 

Get /set raw offset of GMT in millis. 

// more... 
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numbers and statics 



Even wore Statics!... static imports 

New to Java 5 . 0 ... a real mixed blessing. Some people love 
this idea, some people hate it. Static imports exist only to save 
you some typing. If you hate to type, you might just like this 
feature. The downside to static imports is that - if you’re not 
careful - using them can make your code a lot harder to read. 

The basic idea is that whenever you’re using a static class, a 
static variable, or an enum (more on those later) , you can 
import them, and save yourself some typing. 



Some old-fashioned code: 

import j ava . lang .Math; 

class NoStatic { 



Use Carefully: 

static imports can 
make your code 
confusing to read 



public static void main (String [] args) { 



System. out . println ( "sqrt 
System. out . println ( "tan v 



" + Math. sqrt (2.0) ) ; 
+ Math . tan ( 60 ) ) ; 



} 

} 

Same code, with static imports: 

import static java . lang . System. out ; 
import s ta tic j ava . lang . Math . * ; 

class WithStatic { 

public static void main (String [] 
out . println ( "sqrt " + sqrt (2.0)) 
out .println ("tan " + tan( 60 )); 

y 

Statid impovts in adtion. 











args) { 



Caveats & Gotchas 



■ If you’re only going to use a static member 
a few times, we think you should avoid 
static imports, to help keep the code more 
readable. 

■ If you’re going to use a static member a lot, 
(like doing lots of Math calculations), then 
it’s probably OK to use the static import. 

■ Notice that you can use wildcards (.*), in 
your static import declaration. 

■ A big issue with static imports is that it’s 
not too hard to create naming conflicts. For 
example, if you have two different classes 
with an “add()” method, how will you and 
the compiler know which one to use? 
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static vs. instance 



Fireside Chats 




Tonight’s Talk: An instance variable 
takes cheap shots at a static variable 



Instance Variable Static Variable 

I don’t even know why we’re doing this. 

Everyone knows static variables are just used 
for constants. And how many of those are 
there? I think the whole API must have, what, 
four? And it’s not like anybody ever uses 
them. 



Full of it. Yeah, you can say that again. OK, 
so there are a few in the Swing library, but 
everybody knows Swing is just a special case. 



Ok, but besides a few GUI things, give me an 
example of just one static variable that anyone 
would actually use. In the real world. 



Well, that’s another special case. And nobody 
uses that except for debugging anyway. 



You really should check your facts. When 
was the last time you looked at the API? It’s 
frickin’ loaded with statics! It even has entire 
classes dedicated to holding constant values. 
There’s a class called SwingConstants, for 
example, that’s just full of them. 

It might be a special case, but it’s a really 
important one! And what about the Color 
class? What a pain if you had to remember the 
RGB values to make the standard colors? But 
the color class already has constants defined 
for blue, purple, white, red, etc. Very handy. 



How’s System. out for starters? The out in 
System. out is a static variable of the System 
class. You personally don’t make a new 
instance of the System, you just ask the System 
class for its out variable. 

Oh, like debugging isn’t important? 

And here’s something that probably never 
crossed your narrow mind — let’s face it, static 
variables are more efficient. One per class 
instead of one per instance. The memory 
savings might be huge! 
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numbers and statics 



Instance Variable 


Static Variable 


Um, aren’t you forgetting something? 

Static variables are about as un-OO as it gets!! 
Gee why not just go take a giant backwards 
step and do some procedural programming 
while we’re at it. 


What? 


You’re like a global variable, and any 
programmer worth his PDA knows that’s 
usually a Bad Thing. 


What do you mean un-OO? 




I am NOT a global variable. There’s no such 
thing. I live in a class! That’s pretty OO you 
know, a CLASS. I’m not just sitting out there 
in space somewhere; I’m a natural part of the 
state of an object; the only difference is that 
I’m shared by all instances of a class. Very 
efficient. 


Yeah you live in a class, but they don’t call 
it C/ass-Oriented programming. That’s just 
stupid. You’re a relic. Something to help the 
old-timers make the leap to java. 


Alright just stop right there. THAT is 
definitely not true. Some static variables are 
absolutely crucial to a system. And even the 
ones that aren’t crucial sure are handy. 


Well, OK, every once in a while sure, it makes 
sense to use a static, but let me tell you, abuse 
of static variables (and methods) is the mark 
of an immature OO programmer. A designer 
should be thinking about object state, not class 
state. 


Why do you say that? And what’s wrong with 
static methods? 


Static methods are the worst things of all, 
because it usually means the programmer is 
thinking procedurally instead of about objects 
doing things based on their unique object 
state. 

Riiiiiight. Whatever you need to tell yourself... 


Sure, I know that objects should be the focus 
of an OO design, but just because there are 
some clueless programmers out there... don’t 
throw the baby out with the bytecode. There’s 
a time and place for statics, and when you 
need one, nothing else beats it. 
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be the compiler 




class StaticSuper{ 



static { 

System. out .print In ( "super 



BE th& compiler 




The Java file on this page represents a 
complete program. Your job is to play 
compiler and determine whether this 
file will compile. If it won’t compile, 
how would you fix it, and 
if it does compile, what 
would be its output? 



static block" ) ; 



} 



StaticSuper{ 

System . out . println ( 

"super constructor"); 

} 

} 

public class StaticTests extends StaticSuper { 
static int rand; 

static { 

rand = (int) (Math . random ( ) * 6); 

System. out .println ( "static block " + rand); 

} 



If it compiles, which of these is 
the output? 



Possible Output 



| File Edit Window Help Cling 


| 


%java StaticTests 




static block 4 




in main 




super static block 




super constructor 




constructor 





StaticTests ( ) { 

System. out .println ( "constructor" ) ; 

} 

public static void main (String [] args ) { 
System. out . println ( "in main"); 
StaticTests st = new StaticTests () ; 

} 

} 
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numbers and statics 




This chapter explored the wonderful, static, world 
of Java. Your job is to decide whether each of the 
following statements is true or false. 




Twe on FaL.se 




1 . To use the Math class, the first step is to make an instance of it. 

2. You can mark a constructor with the static keyword. 

3. Static methods don’t have access to instance variable state of the ‘this’ object. 

4. It is good practice to call a static method using a reference variable. 

5. Static variables could be used to count the instances of a class. 

6. Constructors are called before static variables are initialized. 

7. MAX_SIZE would be a good name for a static final variable. 

8. A static initializer block runs before a class’s constructor runs. 

9. If a class is marked bnal, all of its methods must be marked bnal. 

10. A bnal method can only be overridden if its class is extended. 

1 1 . There is no wrapper class for boolean primitives. 

12. A wrapper is used when you want to treat a primitive like an object. 

13. The parseXxx methods always return a String. 

14. Formatting classes (which are decoupled from I/O), are in the java.format 
package. 
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code magnets 

Lunar Code Magnets 

This one might actually be useful! In addition to what you've learned in the last few 
pages about manipulating dates, you'll need a little more information... First, full 
moons happen every 29.52 days or so. Second, there was a full moon on Jan. 7th, 
2004. Your job is to reconstruct the code snippets to make a working Java program 
that produces the output listed below (plus more full moon dates). (You might not 
need all of the magnets, and add all the curly braces you need.) Oh, by the way, your 
output will be different if you don't live in the mountain time zone. 
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numbers and statics 



Excise Solutions 



True or False 



BE flie compiler 



StaticSuper( ) { 

System. out . println ( 
"super constructor" ) ; 

} 



StaticSuper is a constructor, and must 
have ( ) in its signature. Notice that as 
the output below demonstrates, the static 
blocks for both classes run before either 
of the constructors run. 



Possible Output 

File Edit Window Help Cling 



%java StaticTests 
super static block 
static block 3 
in main 

super constructor 
constructor 



1 . To use the Math class, the first step is to False 

make an instance of it. 

2 . You can mark a constructor with the key- False 
word ‘static’. 

3 . Static methods don’t have access to an True 

object’s instance variables. 

4 . It is good practice to call a static method False 
using a reference variable. 

5 . Static variables could be used to count the True 
instances of a class. 

6. Constructors are called before static vari- False 
ables are initialized. 

7 . MAX_SIZE would be a good name for a True 
static final variable. 



8. A static initializer block runs before a class’s True 
constructor runs. 

9 . If a class is marked final, all of its methods False 
must be marked final. 

10. A final method can only be overridden if False 
its class is extended. 

1 1 . There is no wrapper class for boolean False 

primitives. 

12 . A wrapper is used when you want to treat a True 
primitive like an object. 

13 . The parseXxx methods always return a False 
String. 

14 . Formatting classes (which are decoupled False 
from I/O), are in the java.format package. 
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code magnets solution 



Excise Solutions 



import j ava . util . * ; 

import static java . lang. System. out; 
class FullMoons { 

static int DAY_IM = 1000 * 60 * 60 * 24; 
public static void main (String [] args) { 
Calendar c = Calendar . getlnstance () ; 
c . set (2004,0,7,15,40) ; 
long dayl = c . getTimelnMillis ( ) ; 
for (int x = 0; x < 60; x++) { 

dayl += (DAY_IM * 29.52) 
c . setTimelnMillis (dayl) ; 



Notes on the Lunar Code Magnet: 

You might discover that a few of the 
dates produced by this program are 
off by a day. This astronomical stuff 
is a little tricky, and if we made it 
perfect, it would be too complex to 
make an exercise here. 

Hint: one problem you might try to 
solve is based on differences in time 
zones. Can you spot the issue? 



out.println (String. format ("full moon on %tc" , c) ) ; 



} 



} 



} 



File Edit Window Help Howl 



% java FullMoons 

full moon on Fri Feb 06 04:09:35 MST 2004 
full moon on Sat Mar 06 16:38:23 MST 2004 
full moon on Mon Apr 05 06:07:11 MDT 2004 
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11 exception handling 



Risky Behavior 




Stuff happens. The file isn’t there. The server is down. No matter how 

good a programmer you are, you can't control everything. Things can go wrong. Very wrong. 
When you write a risky method, you need code to handle the bad things that might happen. 

But how do you know when a method is risky? And where do you put the code to handle the 
exceptional situation? So far in this book, we haven't really taken any risks. We've certainly had 
things go wrong at runtime, but the problems were mostly flaws in our own code. Bugs. And 
those we should fix at development time. No, the problem-handling code we're talking about 
here is for code that you can't guaranatee will work at runtime. Code that expects the file to be 
in the right directory, the server to be running, or the Thread to stay asleep. And we have to do 
this now. Because in this chapter, we're going to build something that uses the risky JavaSound 
API. We're going to build a MIDI Music Player. 
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building the MIDI Music Player 



let's make a Music Machine 



Over the next three chapters, we’ll build a few different sound 
applications, including a BeatBox Drum Machine. In fact, 
before the book is done, we’ll have a multi-player version so 
you can send your drum loops to another player, kind of like 
a chat room. You’re going to write the whole thing, although 
you can choose to use Ready-bake code for the GUI parts. 

OK, so not every IT department is looking for a new BeatBox 
server, but we’re doing this to learn more about Java. Building 
a BeatBox is just a way to have fun while we’re learning Java. 

The finished PeatPox looks something like this: 



‘ '~r <» K-beat dn. patw 

by r*H», tbuiwric i, tt. p 



jjf 



0 0 0 



Cyber BeatBox 






Bass Drum 0 !_| L_' _ '3 S! !_ _ _ U _ 

Closed Hi-Hat Z Z 0 Z Z Z 0 0 Z O 0 Z Z Z0 0 

Open Hi-Hat ZZZZZZZZZZZZZZZZ 

Acoustic Snare ZZZZZZZZZZZZZZZZ 
Crash Cymbal Z □ Z Z Z □ Z Z Z Z Z Z Z Z Z Z 
Hand Clap ZZZZZZZZZZZZZZZZ 

High Tom 

Hi Bongo ZZZZZZZZZZZZ000Z 
Maracas (?) Z 0 Z 0 Z M Z & Z 0 Z 0 Z 0 Z 
Whistle 

low Conga DDDGGD0DD 0-0D 0DDD 
Cowbell ZZZZZZZZZZZZZZZZ 
Vi bras lap Z Z Z Z Z Z Z Z Z Z Z Z Z Z Z Z 

Low-mid Tom ZZZZZZZZZZZZZZZZ 
High Agogo ZZZZZZZZZZZZZZZZ 
Open Hi CangaQ Z Z 0 & 0ZZZ Z Z Z 0 0 & Z 



Siam 
Stop 

Tempo Up 
Tempo Down 
sendlt 



dance beat 



Andy: groove #2 
Chris: groove2 revised < 
Nigel: dance beat 



Put checkmarks in the boxes for each of the 16 ‘beats’. For example, on beat 
1 (of 16 ) the Bass drum and the Maracas will play, on beat 2 nothing, and 
on beat 3 the Maracas and Closed Hi-Hat... you get the idea. When you hit 
‘Start’, it plays your pattern in a loop until you hit ‘Stop’. At any time, you 
can “capture” one of your own patterns by sending it to the BeatBox server 
(which means any other players can listen to it) . You can also load any of the 
incoming patterns by clicking on the message that goes with it. 



,ssav> ^ 

servt .LL W our 

aH ^ r 
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exception handling 



Well start with the basics 

Obviously we’ve got a few things to learn before the whole 
program is finished, including how to build a Swing GUI, how 
to connect to another machine via networking, and a little I/O 
so we can send something to the other machine. 

Oh yeah, and the JavaSound API. That ’s where we’ll start in this 
chapter. For now, you can forget the GUI, forget the networking 
and the I/O, and focus only on getting some MIDI-generated 
sound to come out of your computer. And don’t worry if you 
don’t know a thing about MIDI, or a thing about reading or 
making music. Everything you need to learn is covered here. 
You can almost smell the record deal. 



The JavaSound API 

JavaSound is a collection of classes and interfaces added to 
Java starting with version 1 . 3 . These aren’t special add-ons; 
they’re part of the standard J 2 SE class library. JavaSound is split 
into two parts: MIDI and Sampled. We use only MIDI in this 
book. MIDI stands for Musical Instrument Digital Interface, 
and is a standard protocol for getting different kinds of 
electronic sound equipment to communicate. But for 
our BeatBox app, you can think of MIDI as a kind of 
sheet music that you feed into some device you can think 
of like a high-tech ‘player piano’. In other words, MIDI 
data doesn’t actually include any sound, but it does 
include the instructions that a MIDI-reading instrument 
can play back. Or for another analogy, you can think of 
a MIDI file like an HTML document, and the instrument 
that renders the MIDI file (i.e. plays it) is like the Web 
browser. 

MIDI data says what to do (play middle C, and here’s how hard 
to hit it, and here’s how long to hold it, etc.) but it doesn’t say 
anything at all about the actual sound you hear. MIDI doesn’t 
know how to make a flute, piano, or Jimmy Hendrix guitar 
sound. For the actual sound, we need an instrument (a MIDI 
device) that can read and play a MIDI file. But the device is 
usually more like an entire band or orchestra of instruments. And 
that instrument might be a physical device, like the electronic 
keyboard synthesizers the rock musicians play, or it could 
even be an instrument built entirely in software, living in your 
computer. 

For our BeatBox, we use only the built-in, software-only 
instrument that you get with Java. It’s called a synthesizer (some 
folks refer to it as a software synth) because it creates sound. 
Sound that you hear. 



MlPl tile 




^ tA : W dd aVa W’sW-A° 
$<*• a Y' a 'l e ' r ^' a 



<W 



MlPl devi tt knows how to 
Vcad' a MlPl -file and flay badk 
the sound- The devide might 
be a synthesizer keyboard or 
some other kind of instrument- 
Usually, a MlPl instrument 
dan flay a LOT of di-f-ferent 
sounds (fiano, drums, violin, 
etd ), and all at the same time- 
So a MlPl -file isn’t like sheet 
musid -for just one musidian in 
the band — it dan hold the 
farts -for ALL the musidians 
flaying a fartidular song. 
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but it looked so simple 



First we need a Sequencer 

Before we can get any sound to play, we need a Sequencer object. The 
sequencer is the object that takes all the MIDI data and sends it to the right 
instruments. It’s the thing that plays the music. A sequencer can do a lot of 
different things, but in this book, we’re using it strictly as a playback device. Like 
a CD-player on your stereo, but with a few added features. The Sequencer class 
is in the javax.sound.midi package (part of the standard Java library as of version 
1 . 3 ). So let’s start by making sure we can make (or get) a Sequencer object. 



import j avax . sound . midi . * ; 



public class MusicTestl { 






t to* y 



p * *• 



sow 






public void play() { 

Sequencer sequencer = MidiSystem. getSequencer () 



System. out .println ("We got a sequencer") 

} // close play 






sere n«sall^Myi 

n cu one - 

' MidiSys-ten. i» V ve 



- vjc 

US OY\C 



\)3\ic to 3*k the 



public static void main ( String [] args) { 

MusicTestl mt = new MusicTestl () ; 
mt.playO ; 

} // close main 

} // close class Something's wrong! 

This Code won't Compile/ The don. pilev says there's an 
unv-epov-ted exception' that n>wst be caught or declared- 

File Edit Window Help SayWhat? 

I~ \ I 



% javac MusicTestl . j ava 

MusicTestl . j ava : 13 : unreported exception javax.sound.midi. 
MidiUnavailableException ; must be caught or declared to be 
thrown 

Sequencer sequencer = MidiSystem . getSequencer () ; 

A 

1 errors 
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What happens when a method you want to call 
(probably in a class you didn't write) is risky? 



exception handling 



0 Let’s say you want 
to call a method in a 
class that you didn’t 
write. 




(2) That method does 
something risky, 
something that might 
not work at runtime. 




class you 
didn't write 



void moo ( ) { 

if (serverDown) { 
explode ( ) ; 

} 

} 



(3) You need to know 
that the method 
you’re calling is 
risky. 



(4) You then write code 
that can handle the 
failure if it does 
happen. You need to be 
prepared, just in case. 
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when things might go wrong 



Methods in Java use exceptions to tell the calling code, 

"Something Pad Happened. I failed" 



Java’s exception-handling mechanism is a clean, well-lighted way to handle “exceptional 
situations” that pop up at runtime; it lets you put all your error-handling code in one 
easy-to-read place. It’s based on you knowing that the method you’re calling is risky 
(i.e. that the method might generate an exception), so that you can write code to deal 
with that possibility. If you know you might get an exception when you call a particular 
method, you can be prepared for — possibly even recover from — the problem that caused 
the exception. 

So, how do you know if a method throws an exception? You find a throws clause in the 
risky method’s declaration. 



The getSequencer () method takes a risk. It can fail at runtime. 
So it must ‘declare’ the risk you take when you call it. 




2 Platform 









co 



Fo rward St c 



getSequencer 

xattc 



jeynisaiEfi!! 



putoi tc 



Obtains the default sequencer. 



Returns: 

the 

Throws: 



default sequencer 



available due 



if the sequencer 






This p ari teds you mf 

exception __ ih . / 0U Se-fc that 



The API dods Jell you 
•fcha-t 3 rtSe«\uendev -0 
dan -throw an exdepiion 
/VlidiUnavailableExdeptu 
A method has -to dedlav 
the exdep-tions if mi^hf 
■throw. 
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exception handling 



The compiler needs to know 
that YOU know you're calling 
a risky method. 

If you wrap the risky code in something called a 
try/catch, the compiler will relax. 

A try/catch block tells the compiler that you 
know an exceptional thing could happen in the 
method you’re calling, and that you’re prepared 
to handle it. That compiler doesn’t care how you 
handle it; it cares only that you say you’re taking 
care of it. 

import j avax . sound . midi . * ; 

public class MusicTestl { 
public void play() { 



^ ^ a 6 fins' 

Am/A, Ma/ 

**•***&*, QtiSu, 



OAeat- . 



e&'aAA 



At, 












’A 4 A m 'ttm rAo,,/ / 

A ve&tvefo C/7/rtA 






try { 

Sequencer sequencer = MidiSystem. getSequencer () ; 
System. out .println ("Successfully got a sequencer") 
} catch (MidiUnavailableException ex) { 

System. out .println ("Bummer") ; 

} 

} // close play 



to* ^ ; 
•ma ‘W^ 



public static void main (String [] args) { 
MusicTestl mt = new MusicTestl () ; 
mt.playO ; 

} // close main 
} // close class 



block f 
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exceptions are objects 




Don’t try this at home. 




An exception is an object... 
of type Exception. 

Which is fortunate, because it would be much harder 
to remember if exceptions were of type Broccoli. 

Remember from your polymorphism chapters that 
an object of type Exception can be an instance of any 
subclass of Exception. 

Because an Exception is an object, what you catch is an 
object. In the following code, the catch argument 
is declared as type Exception, and the parameter 
reference variable is ex. 



. a >odav^ 



try { 

// do risky thing ^’ s ^ ^ 

«/' 

} catch (Exception ex) { 

// try to recover 

i 

V «C c 






What you write in a catch block depends on the 
exception that was thrown. For example, if a server 
is down you might use the catch block to try another 
server. If the file isn’t there, you might ask the user 
for help Ending it. 
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exception handling 



If it's your code that catches the exception, 
then whose code throws it? 

You’ll spend much more of your Java coding dme handling 
exceptions than you’ll spend creating and throwing them yourself. 

For now, just know that when your code calls a risky method — a 
method that declares an exception — it’s the risky method that 
throws the exception back to you, the caller. 

In reality, it might be you who wrote both classes. It really 
doesn’t matter who writes the code... what matters is knowing 
which method throws the exception and which method catches it. 



ovN s anexcep^ 




-“o' , I 


0 ^7 




x.beepo/ 


calls risky method 





your code 



class with a 
risky method 



When somebody writes code that could throw an exception, they 
must declare the exception. 



(?) Risky, exception-throwing code: 



public void takeRisk() 
if (abandonAHHope) { 

new BadException ( ) ; 

\ 




i \\ nsiov\A 

i > j MUST te\\ ytfaurfot* 

de t.\avW 



BadException { 



throw 



} 



} 



ob J'H d J? ^,0* 



(2) Your code that calls the risky method: 



public void crossFingers () { 



try 



{ 



anOb ject . takeRisk ( ) ; 

(BadException ex) 



catch 



{ 



One metfocl Will 

esttc h wh%t smother 
method tfroWs . An 
exception !s always 
thrown hack to the 
caller. 

The method tfat 
thrown fas to declare 
that it might throw 
the exception. 



System. out .pr in tin ("Aaargh! ' 
ex . prints tackTrace ( ) ; 



If y< 



■ > 7- «eov«r Wo. the exception, at LEAST 
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checked and unchecked exceptions 



Exceptions that ave HOT subclasses of 
RunWExCeption ave checked -Pov by 
the Compilev. They've called “checked 
exceptions" 



The compiler checks for everything 
except RuntimeExceptions. 

The compiler guarantees: 

/T\ If you throw an exception in your code you must declare it using 
the throws keyword in your method declaration. 




Wait just a minute! How come this is the FIRST time 
we’ve had to try/catch an Exception? What about the 
exceptions I've already gotten like NullPointerException 
and the exception for DivideByZero. I even got a 
NumberFormatException from the Integer.parselntO 
method. How come we didn't have to catch those? 

The compiler cares about all subclasses of Exception, 
unless they are a special type, RuntimeException. Any 
exception class that extends RuntimeException gets a 
free pass. RuntimeExceptions can be thrown anywhere, 
with or without throws declarations or try/catch blocks. 
The compiler doesn't bother checking whether a method 
declares that it throws a RuntimeException, or whether the 
caller acknowledges that they might get that exception at 
runtime. 



I'll bite. WHY doesn't the compiler care about those 
runtime exceptions? Aren't they just as likely to bring the 
whole show to a stop? 

Most RuntimeExceptions come from a problem in 
your code logic, rather than a condition that fails at runtime 
in ways that you cannot predict or prevent. You cannot 
guarantee the file is there. You cannot guarantee the server 
is up. But you can make sure your code doesn't index off the 
end of an array (that's what the .length attribute is for). 

You WANT RuntimeExceptions to happen at development 
and testing time. You don't want to code in a try/catch, for 
example, and have the overhead that goes with it, to catch 
something that shouldn't happen in the first place. 

A try/catch is for handling exceptional situations, not flaws 
in your code. Use your catch blocks to try to recover from 
situations you can't guarantee will succeed. Or at the very 
least, print out a message to the user and a stack trace, so 
somebody can figure out what happened. 
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exception handling 



BULLET POINTS 






■ A method can throw an exception when something fails at runtime. 



■ An exception is always an object of type Exception. (Which, as you 
remember from the polymorphism chapters means the object is from a 
class that has Exception somewhere up its inheritance tree.) 



■ The compiler does NOT pay attention to exceptions that are of 
type RuntimeException. A RuntimeException does not have to be 
declared or wrapped in a try/catch (although you’re free to do either or 
both of those things) 

■ All Exceptions the compiler cares about are called ‘checked 
exceptions’ which really means comp/'/er-checked exceptions. Only 
RuntimeExceptions are excluded from compiler checking. All other 
exceptions must be acknowledged in your code, according to the 
rules. 

■ A method throws an exception with the keyword throw, followed by 
a new exception object: 

throw new NoCaff eineException ( ) ; 

■ Methods that might throw a checked exception must announce it with 
a throws Exception declaration. 

■ If your code calls a checked-exception-throwing method, it must 
reassure the compiler that precautions have been taken. 

■ If you’re prepared to handle the exception, wrap the call in a try/catch, 
and put your exception handling/recovery code in the catch block. 

■ If you’re not prepared to handle the exception, you can still make the 
compiler happy by officially ‘ducking’ the exception. Well talk about 
ducking a little later in this chapter. 



-( fi 



Iharpen your pencil 



Things you want to do 



Hctaco^mtive tiP 

'^e *** 

make that ^ as once you put this 
before gomg to sleeps yourself 

book down (assuming V°a^an ^ 

away from Cheerios™ 

challenging than process what 

b^-rr r-uou,d^ 

you’ve read and lea some thing 

:I;i h 5on y topofVOur J ava,so m eofthe 

java might not 'sticky ^ 

Of course this doesn ^ ^ latest 
a physical skih. W ^ kBoxing routine 
probably won’t affect your 
Java learning. 

For the best results, read this 

book (or at least look at 

the pictures) right before 

going to sleep. 



What might go wrong 



Which of these do you think 
might throw an exception that 
the compiler would care about? 
We're only looking for the 
things that you can't control in 
your code. We did the first one. 

(Because it was the easiest.) 



V*co n n ect to a re m ote se rve r the sewer is down 

access an array beyond its length 

display a window on the screen 

retrieve data from a database 

see if a text file is where you think it is 

create a new file 

__ read a character from the command-line 
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exceptions and flow control 



Flow control in try/catch blocks 

When you call a risky method, one of two things can hap- 
pen. The risky method either succeeds, and the try block 
completes, or the risky method throws an exception back to 
your calling method. 



If the try SUCCeedS 

(doRiskyThing() does not 
throw an exception) 



ta-ttVi vw 14 - 



try { 




If the try fails 

(because doRiskyThing() 
does throw an exception) 



, UotV. ^ 

— ;; doe ^- 

***** ** 

T u*A 
tW •o etV '° a 



\,\otV 



try { 
-(T)-Foo f 

int b 



x . doRiskyThing ( ) ; 
f . getNum ( ) ; 



ws v>\°«* ^ 



«*•* 



the 1 



©- 



(£-► 



} catch (Exception ex) { 


| File Edit Window Help RiskAII | 


► System . out . println ( "failed" ) ; 


%java Tester 


T 


failed 


► System . out . println ( "We made it!"); 


We made it! 
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Finally: for the things you want 
to do no matter what 



exception handling 



If you try to cook something, you start by turning on 
the oven. 

If the thing you try is a complete failure, 
you have to turn off the oven. 

If the thing you try succeeds, 
you have to turn off the oven. 

You have to turn off the oven no matter what! 

A finally block is where you put 
code that must run regardless 
of an exception. 

try { 

turnOvenOn ( ) ; 
x . bake ( ) ; 

} catch (BakingException ex) { 
ex . printStackTrace () ; 

} finally { 

turnOvenOf f ( ) ; 




} 



Without finally, you have to put the 
turnOvenOff() in both the try and the catch 
because you have to turn off the oven no matter 
what. A finally block lets you put all your 
important cleanup code in one place instead of 
duplicating it like this: 



If the try block fails (an exception), flow 
control immediately moves to the catch block, 
When the catch block completes, the finally 
block runs. When the finally block completes, 
the rest of the method continues on. 



try { 

turnOvenOn ( ) ; 
x . bake ( ) ; 
turnOvenOf f () ; 

} catch (BakingException ex) 
ex . printStackTrace () ; 
turnOvenOf f ( ) ; 



} 



If the try block succeeds (no exception), 

flow control skips over the catch block and 
moves to the finally block. When the finally 
block completes, the rest of the method 
continues on. 

If the try or catch block has a return 
statement, finally will still run! Flow 
jumps to the finally, then back to the return. 
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flow control exercise 




Flow Control 



Look at the code to the left. What do you think the 
output of this program would be? What do you think 
it would be if the third line of the program were 
changed to: String test = "yes"; ? 

Assume ScaryException extends Exception. 



public class TestExceptions { 

public static void main (String [] args) { 

String test = "no"; 
try { 

System. out .println( "start try" ) ; 
doRisky (test ) ; 

System. out .println( "end try"); 

} catch ( ScaryException se) { 

System. out .println( "scary exception" ) ; 

} finally { 

System, out .println( "finally" ) ; 

} 

System. out .println( "end of main"); 

} 

static void doRisky ( String test) throws ScaryException { 
System. out .println( "start risky" ) ; 
if ( "yes" .equals (test ) ) { 

throw new ScaryException ( ) ; 

} 

System. out .println( "end risky" ) ; 
return; 

} 

} 



Output when test = "no" 



Output when test = "yes 



ineiuppua - A||euy - uopdaoxa Ajbds - A>|Sujjbjs - Ajjubjs :„S0A„ = jsaj uaq/\/\ 
mew p pus - A||euy - Anpua - A>|su pus - A^sujjbis - Ajjjjbjs :„ou„= jssj usl|/\/\ 
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exception handling 



Pid we mention that a method can 
throw more than one exception? 

A method can throw multiple exceptions if it darn well needs to. But 
a method’s declaration must declare all the checked exceptions it can 
throw (although if two or more exceptions have a common superclass, the 
method can declare just the superclass.) 



Catching multiple exceptions 

The compiler will make sure that you’ve handled all the checked excep- 
tions thrown by the method you’re calling. Stack the catch blocks under 
the try , one after the other. Sometimes the order in which you stack the 
catch blocks matters, but we’ll get to that a little later. 






public class Laundry { 

public void doLaundry ( ) throws PantsException , 

// code that could throw either exception 



} 



} 



TWs 



LingerieException 

^ { c IvJO, tow*' { 



T W0 






public class Foo { 

public void go ( ) { 

Laundry laundry = new Laundry () ; 

try { 

laundry . doLaundry ( ) ; 

} catch (PantsException pex) 

// recovery code 

} catch (LingerieException lex) { 

// recovery code 

} 



n 



it doL-dundvyO 'UvroY/s j 

Pan-tsExiep-tion, ’t ^nds in the 

PaivtsExdep-tion datdh blodk. 



{ 



} 






} 
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polymorphic exceptions 



Exceptions are polymorphic 



Exceptions are objects, remember. There’s nothing all that 
special about one, except that it is a thing that can be thrown. 

So like all good objects, Exceptions can be referred to 
polymorphically. A LingerieException object, for example, 
could be assigned to a ClothingException reference. A 
PantsException could be assigned to an Exception reference. 
You get the idea. The benefit for exceptions is that a method 
doesn’t have to explicitly declare every possible exception it 
might throw; it can declare a superclass of the exceptions. 
Same thing with catch blocks — you don’t have to write a catch 
for each possible exception as long as the catch (or catches) 
you have can handle any exception thrown. 



(?) You can DECLARE exceptions using 
a supertype of the exceptions you 



throw. 






public void doLaundryO throws ClothingException { 

y 






•hdividu^l/y. 



without 






(\\\ eK-teftio^ '' ave 




( 2 ) You can CATCH exceptions using a 
supertype of the exception thrown. 



try { 

laundry . doLaundry ( ) ; 

8 ' 

} catch (ClothingException cex) { 

// recovery code 



'° T ' 

^ svaV> 6\3 sS 



try { 

laundry . doLaundry ( ) ; 









} catch (Shir tException sex) { 

// recovery code 

} 
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exception handling 



Just because you CAN catch everything 
with one big super polymorphic catch, 
doesn’t always mean you SHOULD. 

You could write your exception-handling code so that 
you specify only one catch block, using the supertype 
Exception in the catch clause, so that you’ll be able to 
catch any exception that might be thrown. 

try { 

laundry . doLaundry ( ) ; 

} catch (Exception ex) { 

// recovery code . . . ^ 

} 



c wMT? tm* 

R ftovcvw *' ror * W i • - vjoia vjom 






Write a different catch block for each 
exception that you need to handle 
uniquely. 

For example, if your code deals with (or recovers 
from) a TeeShirtException differently than it handles a 
LingerieException, write a catch block for each. But if you 
treat all other types of ClothingException in the same way, 
then add a ClothingException catch to handle the rest. 



try { 

laundry . doLaundry ( ) ; 



t 



} catch (TeeShirtException tex) { 

// recovery from TeeShirtException 






} catch (LingerieException lex) { 

// recovery from LingerieException 

& % 

} catch (ClothingException cex) { ^ 

// recovery from all others 

} 



*«««■* “ bk 



' I 

,V>\otV*- 



All other- Clo-fehi, 

a> " e here. 



‘SExtepii, 



•Ohs 
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order of multiple catch blocks 



Multiple catch blocks must be ordered 
from smallest to biggest 



ClothingException 





catch (ClothingException cex) 



The higher up the inheritance tree, the bigger the 
catch ‘basket’. As you move down the inheritance 
tree, toward more and more specialized Exception 
classes, the catch ‘basket’ is smaller. It’s just plain old 
polymorphism. 

A ShirtException catch is big enough to take 
a TeeShirtException or a DressShirtException 
(and any future subclass of anything that extends 
ShirtException). A ClothingException is even bigger 
(i.e. there are more things that can be referenced 
using a ClothingException type) . It can take an 
exception of type ClothingException (duh), and 
any ClothingException subclasses: PantsException, 
UniformException, LingerieException, and 
ShirtException. The mother of all catch arguments 
is type Exception; it will catch any exception, 
including runtime (unchecked) exceptions, so you 
probably won’t use it outside of testing. 
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exception handling 



You can't put bigger baskets 
above smaller baskets. 



Well, you can but it won’t compile. Catch 
blocks are not like overloaded methods 
where the best match is picked. With catch 
blocks, the JVM simply starts at the first one 
and works its way down until it finds a catch 
that’s broad enough (in other words, high 
enough on the inheritance tree) to handle 
the exception. If your first catch block is 
catch (Exception ex) , the compiler 
knows there’s no point in adding any 
others — they’ll never be reached. 




} catch (ClothingException cex) { 

// recovery from ClothingException 




} catch (Linger ieException lex) { 

// recovery from LingerieException 





} catch (Shir tException sex) { 

// recovery from ShirtException 

} 



Siblings can be in any order, because they 
can’t catcb one another’s exceptions. 

You could put ShirtException above 
LingerieException and nobody would mind. 
Because even though ShirtException is a bigger 
(broader) type because it can catch other classes 
(its own subclasses), ShirtException can't catch a 
LingerieException so there's no problem. 
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polymorphic puzzle 



Assume the try/catch block here is legally coded. Your task is to draw 
two different class diagrams that can accurately reflect the Exception 
classes. In other words, what class inheritance structures would make the 
try/catch blocks in the sample code legal? 

try { 

x . doRisky ( ) ; 

} catch (AlphaEx a) { 

// recovery from AlphaEx 

} catch (BetaEx b) { 

// recovery from BetaEx 

} catch (GammaEx c) { 

// recovery from GammaEx 

} catch (DeltaEx d) { 

// recovery from DeltaEx 

} 





Your task is to create two different legal try / catch structures (similar to 
the one above left), to accurately represent the class diagram shown on 
the left. Assume ALL of these exceptions might be thrown by the method 
with the try block. 
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Whew you don't wawt to handle 
an exception... 



exception handling 



just duck it 



If you don’t want to handle an 
exception, you can duck it by 
declaring it. 

When you call a risky method, the compiler 
needs you to acknowledge it. Most of the time, 
that means wrapping the risky call in a try/ 
catch. But you have another alternative, simply 
duck it and let the method that called you catch 
the exception. 

It’s easy — all you have to do is declare that 
you throw the exceptions. Even though, 
technically, you aren’t the one doing the 
throwing, it doesn’t matter. You’re still the one 
letting the exception whiz right on by. 

But if you duck an exception, then you don’t 
have a try/ catch, so what happens when the 
risky method (doLaundryO) does throw the 
exception? 

When a method throws an exception, that 
method is popped off the stack immediately, 
and the exception is thrown to the next 
method down the stack — the caller. But if the 
caller is a ducker, then there’s no catch for it so 
the caller pops off the stack immediately, and 
the exception is thrown to the next method 
and so on... where does it end? You’ll see a 
little later. 



public void foo() throws ReallyBadException { 
// call risky method without a try/catch 
laundry . doLaundry ( ) ; 

} 




N_ £ N, ^ 
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handle or declare 



Pucking (by declaring) only 
delays the inevitable 



Sooner or later, somebody has to 
deal with it. But what if main() 
ducks the exception? 

public class Washer { 

Laundry laundry = new Laundry (); 

public void foo() throws ClothingException 

laundry . doLaundry ( ) ; 

} 



public static void main (String [] args) throws ClothingException { 
Washer a = new Washer (); 
a . f oo ( ) ; 

} 

} 



O doLaundryO throws a 
ClothingException 



@ foo() ducks the 
exception 



O main() ducks the The JVM 

exception shuts down 



l d oLaund^y^ 

main() calls foo() 

foo() calls doLaundryO 

doLaundryO is 
running and throws a 
ClothingException 




doLaundryO pops off the 
stack immediately and 
the exception is thrown 
back to foo(). 

But f oo() doesn't have a 
try/catch, so... 



foo() pops off the 
stack immediately and 
the exception is thrown 
back to... who? What? 
There's nobody left 
but the JVM, and it's 
thinking, "Don't expect 
ME to get you out of 
this." 



I We’re using the tee-shirt to represent a Clothing 
*■* Exception. We know, we know... you would 
have preferred the blue jeans. 
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exception handling 



Handle or Declare. It’s the law. 

So now we’ve seen both ways to satisfy the compiler 
when you call a risky (exception-throwing) method. 



® HANDLE 

Wrap the risky call in a try/catch 
try { 

laundry . doLaundry ( ) ; 

} catch (ClothingException cex) 

// recovery code 

} 



1 C the £or*pi| cv » wj || 

yoxVe Mi taltWm 9 all 



of -the 



exfiep-fci, 



•Ohs. 



© DECLARE (duck it) 

Declare that YOUR method throws the same exceptions 
as the risky method you're calling. 



The 



void foo() throws ClothingException 

laundry . doLaundry () ; ^ 

} 



, A r yO 

^ 



tool) 

\\o 



But now this means that whoever calls the foo() method 
has to follow the Handle or Declare law. If foo() ducks 
the exception (by declaring it), and mainQ calls foo(), then 
mainQ has to deal with the exception. 



public class Washer { 

Laundry laundry = new Laundry (); 



public void foo() throws ClothingException { 



laundry . doLaundry ( ) ; 



public static void main (String [] args) 
Washer a = new Washer (); 
a . too ( ) ; 



“■'tat-fclww lt p 
tnvows Clo-thmgExdep-tioh/ 
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fixing the Sequencer code 



(retting back to our music code... 

Now that you’ve completely forgotten, we started this chapter 
with a first look at some JavaSound code. We created a Se- 
quencer object but it wouldn’t compile because the method 
Midi.getSequencer() declares a checked exception (MidiUnavail- 
ableException) . But we can fix that now by wrapping the call in a 
try/ catch. 



public void play() { 

try { 




.jffjKSCfc 

taW‘ Wodt ' 



Sequencer sequencer = MidiSystem. getSequencer () ; 
System. out .println ("Successfully got a sequencer") ; 



} catch (MidiUnavailableException ex) 

System. out .println ("Bummer") ; 

} 

} // close play 



The 

{ ihc 






Exception Rules 



L f c 



tod f 



Wo * i fa L^t u ^ui eE . e?ol y~ 



s *d 



Ki'ko- 









0 You cannot have a catch or finally 
without a try 

void go ( ) { ? 

Foo f = new Foo ( ) ; \tf\\Ccl s ^X'l’ 

f .foot () ; 

catch (FooException ex) 



(|) A try MUST be followed by either a 
catch or a finally LEa a 

try { have a ^ you 

X . doStuf f ( ) ; , V' even 



} finally { 

// cleanup 






w / 0 “ 
ytyHself. 






(2) You cannot put code between the 
try and the catch 



try { 

x . doStuf f ( ) ; 



n °tle<$a l i v 

L° de kei »een ^ 

ihe taieh. h 



int y = 43; 

} catch (Exception ex) 



( 4 ) A try with only a finally (no catch) 
must still declare the exception. 

void go() throws FooException { 



try { 

x . doStuf f ( ) ; 
} finally { } 



f\ Vf *«■ 









AoeS ^ Sa tSa^ 
0X Aefc 
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exception handling 



Code Kitcken 



- 




You don’t kave to do it 
yourself, kut it’s a lot 
more fun if you do. 

Tke rest of tkis ckapter 
is optional; you can use 
Ready -Lake code for all 
tke music apps. 

But if you want to learn 
more akout JavaSound, 
turn tke page. 
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JavaSound MIDI classes 



Making actual sound 

Remember near the beginning of the chapter, we looked at how MIDI data holds 
the instructions for what should be played (and how it should be played) and we 
also said that MIDI data doesn’t actually create any sound that you hear. For sound 
to come out of the speakers, the MIDI data has to be sent through some kind of 
MIDI device that takes the MIDI instructions and renders them in sound, either 
by triggering a hardware instrument or a ‘virtual’ instrument (software synthe- 
sizer) . In this book, we’re using only software devices, so here’s how it works in 
JavaSound: 



You need FOUR things: 



(T) The thing that 
plays the music 



( 5 ) The music to be 
played... a song. 



(3) The part of the 
Sequence that 
holds the actual 
information 



(4) The actual music 
information: 
notes to play, 
how long, etc. 



plays 

Sequencer ► 




The Sequencer is the thing 
that actually causes a song 
to be played. Think of it like 

a music CD player. 



has a 

Sequence ► Track 




The Sequence is the 
song, the musical piece 
that the Sequencer will 
play. For this book, think 
of the Sequence as a 
music CD, but the whole 
CD plays just one song. 



For this book, we only 
need one Track, so just 
imagine a a music CD 
with only one song. A 
single Track. This Track 
is where all the song 
data (MIDI information) 
lives. 



“f 



^ C T) (Vas 

aV*^ V '°' N 



C, e o 




A MIDI event is a message 
that the Sequencer can 
understands MIDI event 
might say (if it spoke 
English), "At this moment 
in time, play middle C, play 
it this fast and this hard, 
and hold it for this long." 

A MIDI event might 
also say something like, 
"Change the current 
instrument to Flute." 
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exception handling 



And you need FIVE steps: 

(T) Set a Sequencer and open it 

Sequencer player = MidiSystem. getSequencer () ; 
player . open ( ) ; 

(2) Make a new Sequence 

Sequence seq = new Sequence (timing, 4 ) ; 

(3) Get a new Track from the Sequence 

Track t = seq. createTrack ( ) ; 

(4) Fill the Track with MidiEvents and 
give the Sequence to the Sequencer 
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a sound application 



Your very first sound player app 

Type it in and run it. You’ll hear the sound of someone playing a 
single note on a piano! (OK, maybe not someone, but something.) 



import javax. sound. midi . *; 
public class MiniMiniMusicApp { 



U *•* midi packag. 



public static void main (String [ ] args) { 

MiniMiniMusicApp mini = new MiniMiniMusicApp () ; 
mini . play ( ) ; 

} // close main 

public void play() { 

try { 



•F 



© 

© 

© 



Seguencer player = MidiSystem. getSequencer () ; 
player . open ( ) ; 



Sequence seq = new Sequence (Sequence . PPQ, 4); 






, eva< ,do^'\ 



(so 



tarx ' 



A .<*** 



^ tO^ C 1 







Track track = seq . createTrack ( ) ; 



^ShortMessage a = new ShortMessage ( ) ; 
a . setMessage (144 , 1, 44, 100); 

MidiEvent noteOn = new MidiEvent (a, 1); 
track. add (noteOn) ; 



ShortMessage b = new ShortMessage () ; 
b. setMessage (128, 1, 44, 100); 

MidiEvent noteOff = new MidiEvent (b, 16), 
track. add (noteOff) ; 



'<* as 1 



Ask -the Serene,, for a Track Re u i, 

Track lives in c Ke "' ewbe ' r ' &e 

Px-t some /VJidiEve„-b iUo the Tvadk. This P aU 

r rBOS , il y R<ad y- bak ' The only thin* you'll 
have to care about ave the argents to the 
setMessayO method , and the argents to 
the MidiEvent Constructor. We’ll look at those 
arguments on the next page. 



player . setSequence (seq) ; ^ ^ ^ ^ (|, ke 

player, start () ; j putting the CP in the CP player) 

Star t() o 

} catch (Exception ex) { Veneer flifc e 

ex . printStackTrace () ; PXshi^g P My0 



} // close play 
} // close class 
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exception handling 



Making a MidiEvent (song data) 

A MidiEvent is an instruction for part of a song. A series of MidiEvents is 
kind of like sheet music, or a player piano roll. Most of the MidiEvents we 
care about describe a thing to do and the moment in time to do it. The moment 
in time part matters, since timing is everything in music. This note follows 
this note and so on. And because MidiEvents are so detailed, you have to say 
at what moment to start playing the note (a NOTE ON event) and at what 
moment to stop playing the notes (NOTE OFF event). So you can imagine 
that firing the “stop playing note G” (NOTE OFF message) before the “start 
playing Note G” (NOTE ON) message wouldn’t work. 

The MIDI instruction actually goes into a Message object; the MidiEvent is 
a combination of the Message plus the moment in time when that message 
should ‘fire’. In other words, the Message might say, “Start playing Middle 
C” while the MidiEvent would say, “Trigger this message at beat 4 ”. 

So we always need a Message and a MidiEvent. 

The Message says what to do, and the MidiEvent says when to do it. 



@ Make a Message 

ShortMessage a = new ShortMessage ( ) ; 



A MidiEvent says 
what to do and 
when to do it. 

Every instruction 
must include the 
timing tor that 
instruction. 

In other words, at 
which heat that 
thing should happen. 



( 2 ) Put the Instruction in the Message 

a . setMessage ( 144 , 1 , 44, 100); 

(§) Make a new MidiEvent using the Message 

MidiEvent noteOn = new MidiEvent (a, 1) , 

(4) Add the MidiEvent to the Track 

track . add (noteOn) , 



•start 



ae & 



TW* othev ***** 

/ »\\ look at the OV 



the 



(WW \°* 

Y*S e ' 



•) 



Afidi- 






v * 



a Track .» 

tkc- accordin, b ■? irtt'TL V- «T k« ^ 



I L» _ SdmC wowcwt X 
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dfC-C event 
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contents of a Midi event 



MIPI message: the heart of a MidiEvewt 

A MIDI message holds the part of the event that says what to do. The actual instruction 
you want the sequencer to execute. The first argument of an instruction is always the type 
of the message. The values you pass to the other three arguments depend on the type of 
message. For example, a message of type 144 means “NOTE ON”. But in order to carry 
out a NOTE ON, the sequencer needs to know a few things. Imagine the sequencer saying, 
“OK, I’ll play a note, but which channel? In other words, do you want me to play a Drum 
note or a Piano note? And which note ? Middle-C? D Sharp? And while we’re at it, at which 
velocity should I play the note? 

To make a MIDI message, make a ShortMessage instance and invoke setMessage(), passing 
in the four arguments for the message. But remember, the message says only what to do, so 
you still need to stuff the message into an event that adds when that message should ‘fire’. 



Anatomy of a message 

The first argument to setMessage() always 
represents the message 'type, while the other 
three arguments represent different things 
depending on the message type. 



a . setMessage 



Ac 3 ^ 

° ihcir arc -for iL. W .****& so ■ 




128 means 
NOTE OFF 
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(T) Message type 

144 means 
NOTE ON 



The Message says what to do, the 
MidiEvent says when to do it. 



(2) Channel 

Think of a channel like a musician in 
a band. Channel 1 is musician 1 (the 
keyboard player), channel 9 is the 
drummer, etc. 



(3) Note to play 



A number from 0 to 127, going 
from low to high notes. 




good default. 
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exception handling 



Change a message 

Now that you know what’s in a Midi message, you can start experimenting. You 
can change the note that’s played, how long the note is held, add more notes, 
and even change the instrument. 



(T) Change the note 

Try a number between 0 and 127 in the note 
on and note off messages. 

a . setMessage (144, 1, 2 0, 100); 




(|) Change the duration of the note 

Change the note off event (not the message) so 
that it happens at an earlier or later beat. 

b . setMessage ( 128 , 1, 44, 100); 
MidiEvent noteOf f = new MidiEvent (b, 3 




(3) Change the instrument 

Add a new message, BEFORE the note-playing message, 
that sets the instrument in channel 1 to something other 
than the default piano. The change-instrument message 
is '192', and the third argument represents the actual 
instrument (try a number between 0 and 127) 



first . setMessage (192, 1, 102, 
\ \ V A 

A' 

Vo* . 









A 












\p 
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change the instrument and note 



Version 2 : Using command-line args to experiment with sounds 

This version still plays just a single note, but you get to use command-line argu- 
ments to change the instrument and note. Experiment by passing in two int values 
from 0 to 127. The first int sets the instrument, the second int sets the note to play. 

import javax. sound. midi . *; 

public class MiniMusicCmdLine { // this is the first one 

public static void main (String [ ] args) { 

MiniMusicCmdLine mini = new MiniMusicCmdLine () ; 
if (args. length < 2) { 

System. out .println ("Don' t forget the instrument and note args"); 
} else { 

int instrument = Integer .parselnt (args [ 0 ]) ; 
int note = Integer .parselnt (args [ 1 ]) ; 
mini .play (instrument , note); 

} 

} // close main 

public void play (int instrument, int note) { 
try { 



Sequencer player = MidiSystem. getSequencer () ; 
player . open ( ) ; 

Sequence seq = new Sequence (Sequence . PPQ, 4); 
Track track = seq . createTrack ( ) ; 



MidiEvent event = null; 

ShortMessage first = new ShortMessage ( ) ; 
first . setMessage ( 1 92 , 1, instrument, 0); 

MidiEvent changelnstrument = new MidiEvent (first, 1); 
track . add (changelnstrument) ; 



ShortMessage a = new ShortMessage () ; 

a . setMessage ( 144 , 1, note, 100); 

MidiEvent noteOn = new MidiEvent (a, 1); 

track . add (noteOn) ; 

ShortMessage b = new ShortMessage () ; 

b . setMessage (128, 1, note, 100); 

MidiEvent noteOff = new MidiEvent (b, 16); 
track . add (noteOff) ; 

player . set Sequence (seq) ; 
player . start ( ) ; 



Ru y\ i-t with two int av-js -from 0 
to 1 2-1. T v-y these (or stav-tev-s: 



| File Edit ’ 


Window Help Attenuate 




| 


% java 


MiniMusicCmdLine 


102 


30 


% java 


MiniMusicCmdLine 


80 


20 


% java 


MiniMusicCmdLine 


40 


70 



} catch (Exception ex) 
} // close play 
// close class 



{ ex .printStackTrace ( ) ; } 



346 chapter 1 1 



Head First Java, 2nd Edition. Head First Java, 2nd Edition, ISBN: 0596009208 

Prepared for e.simons@icarin.fiuc.org, Eduard Simons 

Copyright © 2005 Bert Bates and Kathy Sierra. This PDF is made available for personal use only during the relevant subscription term, subject to the Safari Terms of Service. Any other use 
requires prior written consent from the copyright owner. Unauthorized use, reproduction and/or distribution are strictly prohibited and violate applicable laws. All rights reserved. 





exception handling 



Where we’re headed with the rest 



of the CodeKitchens 

Chapter 15: the goal 

When we're done, we'll have a working 
BeatBox that's also a Drum Chat Client. 
We'll need to learn about GUIs (includ- 
ing event handling), I/O, networking, and 
threads. The next three chapters (12, 13, 
and 14) will get us there. 




Chapter 12: MIDI events 

This CodeKitchen lets us build a little 
"music video" (bit of a stretch to call it 
that...) that draws random rectangles to 
the beat of the MIDI music. We'll learn 
how to construct and play a lot of MIDI 
events (instead of just a couple, as we do 
in the current chapter). 



0 0 0 




0 0 0 


■ 







beat one beat two 







beat three 



~ — 




beat -four ... 



Chapter 13: Stand-alone 
BeatBox 

Now we'll actually build the real BeatBox, 
GUI and all. But it's limited— as soon as you 
change a pattern, the previous one is lost. 
There's no Save and Restore feature, and 
it doesn't communicate with the network. 
(But you can still use it to work on your 
drum pattern skills.) 



GOO 


Cyber BeatBox 


Ban Drum 


s.ur, > 


Cloicd Ml -Mat 


_ _ M 


Open Hi-Mat D 11 ' Trmno UoA 

Acouiltc - '2 L! , 

Crash Cymbal __ MM _____ M _ _ . . _ 


Hand Clap 


□□□□□□□□□□□□□□□a 


High Tom 




Ml Bongo 




Maracai 


: _l___ 


Whiitla 


□□□□□□OOOQOOGOQO 


low Conga 


no no no ononooooon 


Cowbell 




Vlbraslip 


0 


Low- mid Tom 


0 


H»gh Agogo 


* * * 


Open mi Conga _ 2 _ _ □□□□ 



Chapter 14: Save and 
Restore 

You've made the perfect pattern, and 
now you can save it to a file, and reload it 
when you want to play it again. This gets 
us ready for the final version (chapter 15), 
where instead of writing the pattern to a 
file, we send it over a network to the chat 
server. 
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This chapter explored the wonderful world of 
exceptions. Your job is to decide whether each of the 
following exception-related statements is true or false. 



on Fause 




1 . A try block must be followed by a catch and a finally block. 

2. If you write a method that might cause a compiler-checked exception, you 
must wrap that risky code in a try / catch block. 

3. Catch blocks can be polymorphic. 

4. Only ‘compiler checked’ exceptions can be caught. 

5. If you define a try / catch block, a matching finally block is optional. 

6. If you define a try block, you can pair it with a matching catch or finally block, 
or both. 

7. If you write a method that declares that it can throw a compiler-checked ex- 
ception, you must also wrap the exception throwing code in a try / catch block. 

8. The main( ) method in your program must handle all unhandled exceptions 
thrown to it. 

9. A single try block can have many different catch blocks. 

10. A method can only throw one kind of exception. 

11. A finally block will run regardless of whether an exception is thrown. 

12. A finally block can exist without a try block. 

13. A try block can exist by itself, without a catch block or a finally block. 

14. Handling an exception is sometimes referred to as ‘ducking’. 

15. The order of catch blocks never matters. 

16. A method with a try block and a finally block, can optionally declare the 
exception. 

17. Runtime exceptions must be handled or declared. 
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exception handling 





Code Magnets 

A working Java program is scrambled up on the fridge. Can you 
reconstruct all the code snippets to make a working Java program 
that produces the output listed below? Some of the curly braces fell 
on the floor and they were too small to pick up, so feel free to add as 
many of those as you need! 
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puzzle: crossword 




JavaCfaSS 7.0 





1 


2 




3 
















4 














5 


























6 












7 






8 
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10 


11 










12 












13 






















































14 




15 
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20 














21 




22 


















23 




24 


















25 


























26 






















27 












28 




































29 







You know what to do! 



Across 


20. Class hierarchy 


Down 


12. Javac saw it coming 


1. To give value 


21. Too hot to handle 


2. Currently usable 


14. Attempt risk 


4. Flew off the top 


24. Common primitive 


3. Template's creation 


16. Automatic acquisition 


6. All this and more! 


25. Code recipe 


4. Don't show the kids 


17. Changing method 


8. Start 


27. Unruly method action 


5. Mostly static API class 


19. Announce a duck 


10. The family tree 


28. No Picasso here 


7. Not about behavior 


22. Deal with it 


13. No ducking 


29. Start a chain of events 


9. The template 


23. Create bad news 


15. Problem objects 
18. One of Java's '49' 




11. Roll another one off 
the line 


26. One of my roles 



More Hints: 


••• sjoqiunN 'S 
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exception handling 



Exercise Solutions 



Tw on Fai-sg 

1. False, either or both. 

2. False, you can declare the exception. 

3. True. 

4. False, runtime exception can be caught. 

5. True. 

6 . True, both are acceptable. 

7. False, the declaration is sufficient. 

8 . False, but if it doesn’t the JVM may shut 
down. 

9. True. 

10. False. 

11. True. It’s often used to clean-up partially 
completed tasks. 

12. False. 

13. False. 

14. False, ducking is synonomous with declar- 
ing. 

15. False, broadest exceptions must be caught 
by the last catch blocks. 

16. False, if you don’t have a catch block, you 
must declare. 

17. False. 



Code Magnets 

class My Ex extends Exception { } 

public class ExTestDrive { 

public static void main (String [] args) { 
String test = args[0]; 
try { 

System. out .print ( "t" ) ; 
doRisky ( test ) ; 

System. out .print ( "o" ) ; 

} catch ( My Ex e) { 

System. out . print ( "a" ) ; 

} finally { 

System . out . print ( "w" ) ; 

} 

System . out . println ( " s " ) ; 

} 

static void doRisky ( String t) throws My Ex { 
Sy stem. out. print ( "h" ) ; 

if ( "yes" .equals (t) ) { 

throw new My Ex ( ) ; 

} 

Sy stem. out. print ( "r" ) ; 

} 

} I File Edit Window Help Chill 



% java ExTestDrive yes 
thaws 

% java ExTestDrive no 
throws 
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puzzle answers 
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1 2 getting gui 




Wow! This looks great. 
I guess presentation 
really is everything. 



I heard your 
ex-wife could only cook 
command-line meals. 



A Very Graphic 
Story 



•o- 



Face it, you need to make GUIs. If you're building applications that other 



people are going to use, you need a graphical interface. If you're building programs for yourself, 



you want a graphical interface. Even if you believe that the rest of your natural life will be 



spent writing server-side code, where the client user interface is a web page, sooner or later 



you'll need to write tools, and you'll want a graphical interface. Sure, command-line apps are 
retro, but not in a good way.They're weak, inflexible, and unfriendly. We'll spend two chapters 
working on GUIs, and learn key Java language features along the way including Event 
Handling and Inner Classes. In this chapter, we'll put a button on the screen, and make it do 
something when you click it. We'll paint on the screen, we'll display a jpeg image, and we'll even 



do some animation. 
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your first gui 



It all starts with a window 

AJFrame is the object that represents 
a window on the screen. It’s where you 
put all the interface things like buttons, 
checkboxes, text fields, and so on. It can 
have an honest-to-goodness menu bar 
with menu items. And it has all the little 
windowing icons for whatever platform 
you’re on, for minimizing, maximizing, and 
closing the window. 

The JFrame looks different depending on 
the platform you’re on. This is a JFrame on 
Mac OS X: 



_ “If I see one more 
command-line app, 
? * 1 you’re fired.” 





Pot widgets in the window 



Making a GUI is easy: 

(T) Make a frame (a JFrame) 

JFrame frame = new JFrame () ; 

@ Make a widget (button, text field, etc.) 

JButton button = new JButton ("click me") ; 



Once you have a JFrame, you can put 
things (‘widgets’) in it by adding them 
to the JFrame. There are a ton of Swing 
components you can add; look for them 
in the javax. swing package. The most 
common include JButton, JRadioButton, 
JCheckBox, JLabel, JList, JScrollPane, 
JSlider, JTextArea, JTextField, and 
JTable. Most are really simple to use, but 
some (like JTable) can be a bit more 
complicated. 



(3) Add the widget to the frame 

frame . getContentPane () .add (button) ; 



yi* *d he wi 
tU 9 s to he Wi*d< 



ha^e 
ihe 
you add 



@ Display it (give it a size and make it visible) 

frame . setSize (300 , 300) ; 
frame . setVisible (true) ; 
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getting gui 



Your first (MJI; a button on a frame 



import j avax . swing . * ; 



SYiin^ 



public class SimpleGuil { 
public static void main 



( String [] args) { 






Wfcto* 



JFrame frame = new JFrame (); 
JButton button = new JButton ( ' 



,\, e a ^' r3 " >e ' , 

^ (vo« tan yass ti* WfcU tonstr«tW 
click me") ; '/o'* o* °* 



frame . setDef aultCloseOperation (JFrame . EXIT_ON_CLOSE) ; 

^ nu f L * SOOh as y° u 

frame . getContentPane ( ) . add (button) ; ]Usi si+ - 11 1 «** * will 



frame . setSize (300 , 300) ; 

in p ix-L 

frame . setVisible (true) ; • c/s 

\ 

t"? “ ake ^^//^youW 



JUS ' t ^ he ' re <* 0<e Wen -foteveiT 

ad< * ihe bi*Oo n i a ii r , 

W P an e the **"« * 



Let’s see what happens when we run it: 

%java SimpleGuil 




Whoa! That’s a 
Really Big Button. 

The button fills all the 
available space in the frame. 
Later well learn to control 
where (and how big) the 
button is on the frame. 
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user interface events 



Put nothing happens when I click it... 

That’s not exactly true. When you press the button it shows that 
‘pressed’ or ‘pushed in’ look (which changes depending on the 
platform look and feel, but it always does something to show when 
it’s being pressed) . 

The real question is, “How do I get the button to do something 
specific when the user clicks it?” 



We need two things: 

© a method to be called when the user 
clicks (the thing you want to happen as 
a result of the button click). 

© A way to know when to trigger 
that method. In other words, a way 
to know when the user clicks the 
button! 




When the user clicks, we want 
to know. 



We’re interested in the user- 
takes-action-on-a-button event. 



^tliereim-o no 

Dumb Questions 

% Will a button look like a 
Windows button when you run on 
Windows? 



If you want it to. You can 
choose from a few "look and 
feels" — classes in the core library 
that control what the interface looks 
like. In most cases you can choose 
between at least two different looks: 
the standard Java look and feel, also 
known as Metal, and the native look 
and feel for your platform. The Mac 
OS X screens in this book use either 
the OS X Aqua look and feel, or the 
Metal look and feel. 



% Can I make a program look 
like Aqua all the time? Even when 
it's running under Windows? 



Nope. Not all look and feels 
are available on every platform. If 
you want to be safe, you can either 
explicitly set the look and feel to 
Metal, so that you know exactly what 
you get regardless of where the app 
is running, or don't specify a look 
and feel and accept the defaults. 



% 



I heard Swing was dog-slow 
and that nobody uses it. 



This was true in the past, 
but isn't a given anymore. On weak 
machines, you might feel the pain of 
Swing. But on the newer desktops, 
and with Java version 1 .3 and be- 
yond, you might not even notice the 
difference between a Swing GUI and 
a native GUI. Swing is used heavily 
today, in all sorts of applications. 
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getting gui 



(retting a user event 

Imagine you want the text on the button to 
change from click me to I’ve been clicked when 
the user presses the button. First we can write a 
method that changes the text of the button (a 
quick look through the API will show you the 
method) : 



public void changelt() { 

button. setText( "I've been clicked!"); 

} 

But now what? How will we know when this 
method should run? How will we know when the 
button is clicked? 

In Java, the process of getting and handling a 
user event is called event-handling. There are 
many different event types in Java, although 
most involve GUI user actions. If the user clicks 
a button, that’s an event. An event that says 
“The user wants the action of this button to 
happen.” If it’s a “Slow Tempo” button, the user 
wants the slow-tempo action to occur. If it’s a 
Send button on a chat client, the user wants the 
send-my-message action to happen. So the most 
straightforward event is when the user clicked 
the button, indicating they want an action to 
occur. 

With buttons, you usually don’t care about any 
intermediate events like button-is-being-pressed 
and button-is-being-released. What you want to 
say to the button is, “I don’t care how the user 
plays with the button, how long they hold the 
mouse over it, how many times they change their 
mind and roll off before letting go, et c.Just tell 
me when the user means business! In other words, 
don’t call me unless the user clicks in a way that 
indicates he wants the darn button to do what it 
says it’ll do!” 



First, the button needs to know 
that we care. 




0 The us cv tkked "»e! 



Second, the button needs a way 
to call us back when a button- 
clicked event occurs. 




1 ) How could you tell a button object that you 
care about its events? That you're a concerned 
listener? 



2) How will the button call you back? Assume 
that there's no way for you to tell the button the 
name of your unique method (changelt()).So 
what else can we use to reassure the button that 
we have a specific method it can call when the 
event happens? [hint: think Pet] 
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event listeners 



If you care about the button’s events, 




A listener interface is the bridge between the 
listener (you) and event source (the button). 

The Swing GUI components are event sources. In Java terms, 
an event source is an object that can turn user actions (click 
a mouse, type a key, close a window) into events. And like 
virtually everything else in Java, an event is represented as an 
object. An object of some event class. If you scan through the 
java.awt.event package in the API, you’ll see a bunch of event 
classes (easy to spot — they all have Event in the name). You’ll 
find MouseEvent, KeyEvent, WindowEvent, ActionEvent, and 
several others. 

An event source (like a button) creates an event object when the 
user does something that matters (like click the button) . Most 
of the code you write (and all the code in this book) will receive 
events rather than create events. In other words, you’ll spend 
most of your time as an event listener rather than an event source. 

Every event type has a matching listener interface. If you want 
MouseEvents, implement the MouseListener interface. Want 
WindowE vents? Implement WindowListener. You get the idea. 
And remember your interface rules — to implement an interface 
you declare that you implement it (class Dog implements Pet), 
which means you must write implementation methods for every 
method in the interface. 

Some interfaces have more than one method because the 
event itself comes in different flavors. If you implement 
MouseListener, for example, you can get events for 
mousePressed, mouseReleased, mouseMoved, etc. Each of 
those mouse events has a separate method in the interface, 
even though they all take a MouseEvent. If you implement 
MouseListener, the mousePressed () method is called when the 
user (you guessed it) presses the mouse. And when the user lets 
go, the mouseReleased () method is called. So for mouse events, 
there’s only one event object, MouseEvent, but several different 
event methods, representing the different types of mouse events. 
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When you implement a 
listener interface, you give 
the button a way to call 
you back. Tbe interface is 
where the call-back method 
is declared. 
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How the listener and source 
communicate: 



getting gui 




A ^ctionListe ne^^ 



Qcti ° flPerformedC^'*^ 




Tke Listener 



If your class wants to know about 
a button's Action Events, you 
implement the ActionListener 
interface.The button needs to 
know you're interested, so you 
register with the button by calling its 
addActionListener(this) and passing an 
ActionListener reference to it (in this case, 
you are the ActionListener so you pass 
this ) .The button needs a way to call you 
back when the event happens, so it calls 
the method in the listener interface. As an 
ActionListener, you must implement the 
interface's sole method, actionPerformed(). 
The compiler guarantees it. 



Tke Event Source 

A button is a source of Action Events, 
so it has to know which objects are 
interested listeners.The button has an 
addActionListenerO method to give 
interested objects (listeners) a way to 
tell the button they're interested. 

When the button's 
addActionListenerO runs (because 
a potential listener invoked it), the 
button takes the parameter (a 
reference to the listener object) and 
stores it in a list. When the user clicks 
the button, the button 'fires' the event 
by calling the actionPerformedO 
method on each listener in the list. 
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getting events 



Getting a button’s ActionEvent 

© Implement the ActionListener interface 

® Register with the button (tell it you 
want to listen for events) 

© Define the event-handling method (implement 
the actionPerformed() method from the 
ActionListener interrface) 



import j avax . swing . * ; 
import j ava . awt . event . * ; 






a 5 ave ' m ‘ 

ar,d m 



© 






public class SimpleGuilB implements ActionListener { 
JButton button; 

public static void main (String [] args) { 
SimpleGuilB gui = new SimpleGuilB () ; 
gui . go ( ) ; 

} 



sa T’ 






JL*k’" er ' 



k 'dYN 



|\{Aa° v ' L ' 



fcori 



\^° 



public void go() { 

JFrame frame = new JFrame ( ) ; 
button = new JButton ("click me") , 



,, TV ' S ^ 



© 



X 



/ 



button . addActionLis tener ( this ) ; 






?a ss 



,\OYN< 



,u^ Y ' e ' r - 



frame . getContentPane () .add (button) ; 
frame . setDef aultCloseOperation (JFrame . EXIT_ON_CLOSE) ; 
frame . setSize (300 ,300) ; 
frame . setVisible (true) ; 



© 






public void actionPerformed (ActionEvent event) { 
button . setText ("I've been clicked ! " ) ; 



The bu-fctoi, tails -this i i , 

happened- li sends y ou an A C P ^ Tl*™ ** ^ 
argument, but we don't need it ^ * ^ he 

^.d is enough 
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getting gui 



listeners. Sources, and Events 



For most of your stellar Java career, you will not be the source 
of events. 

(No matter how much you fancy yourself the center of your social 
universe.) 

Get used to it. Your job is to be a good listener. 

(Which, if you do it sincerely, can improve your social life.) 



As a listener, my job is to 
implement the interface, 
register with the button, and 
provide the event-handling. 



As an event source, my job is to 
accept registrations (from listeners), 
get events from the user, and 
call the listener's event-handling 
method (when the user clicks me) 






Listener GETS the 
y event 



Source SENDS 
the event 



Hey, what about me? I'm a player too, you 
know! As an event object, I'm the argument 
to the event call-back method (from the 
interface) and my job is to carry data about 
the event back to the listener. 



Event object 
HOLDS DATA 
about the event 



you are here ► 361 



Head First Java, 2nd Edition. Head First Java, 2nd Edition, ISBN: 0596009208 

Prepared for e.simons@icarin.fiuc.org, Eduard Simons 

Copyright © 2005 Bert Bates and Kathy Sierra. This PDF is made available for personal use only during the relevant subscription term, subject to the Safari Terms of Service. Any other use 
requires prior written consent from the copyright owner. Unauthorized use, reproduction and/or distribution are strictly prohibited and violate applicable laws. All rights reserved. 



event handling 



fjiereiqyeno 

Dumb Questions 




Why can't I be a source of events? 



A- 

Jr \ m You CAN. We just said that most of the time 
you'll be the receiver and not the originator of the 
event (at least in the early days of your brilliant Java 
career). Most of the events you might care about 
are 'fired' by classes in the Java API, and all you have 
to do is be a listener for them. You might, however, 
design a program where you need a custom event, say, 
StockMarketEvent thrown when your stock market 
watcher app finds something it deems important. In 
that case, you'd make the StockWatcher object be an 
event source, and you'd do the same things a button 
(or any other source) does — make a listener interface 
for your custom event, provide a registration method 
(addStockListener()),and when somebody calls it, add 
the caller (a listener) to the list of listeners. Then, when 
a stock event happens, instantiate a StockEvent object 
(another class you'll write) and send it to the listeners 
in your list by calling their stockChanged(StockEvent 
ev) method. And don't forget that for every event type 
there must be a matching listener interface (so you'll 
create a StockListener interface with a stockChangedO 
method). 



I don't see the importance of the event object 
that's passed to the event call-back methods. If 
somebody calls my mousePressed method, what 
other info would I need? 

A lot of the time, for most designs, you don't 
need the event object. It's nothing more than a little 
data carrier, to send along more info about the event. 
But sometimes you might need to query the event for 
specific details about the event. For example, if your 
mousePressedO method is called, you know the mouse 
was pressed. But what if you want to know exactly 
where the mouse was pressed? In other words, what if 
you want to know the X and Y screen coordinates for 
where the mouse was pressed? 

Or sometimes you might want to register the same 
listener with multiple objects. An onscreen calculator, 
for example, has 1 0 numeric keys and since they all do 
the same thing, you might not want to make a separate 
listener for every single key. Instead, you might 
register a single listener with each of the 1 0 keys, and 
when you get an event (because your event call-back 
method is called) you can call a method on the event 
object to find out who the real event source was. In 
other words, which key sent this event. 




parpen your pencil 



Each of these widgets (user interface objects) are the 
source of one or more events. Match the widgets with 
the events they might cause. Some widgets might be a 
source of more than one event, and some events can be 
generated by more than one widget. 



Widgets 



Event methods 



check box 


windowClosing() 


text field 


actionPerformed() 


scrolling list 


itemStateChanged() 


button 


mousePressedO 


dialog box 


keyTyped() 


radio button 


mouseExited() 


menu item 


focusGainedQ 



IJow do you KNOW if 
an object is an event 
source? 

Look in the API. 

OK- Look for what? 

A method that starts with 
‘add’, ends with ‘Listener’, 
and takes a listener inter- 
face argument. If you see: 

addKeyListener(KeyListener k) 

you know that a class 
with this method is a 
source of KeyEvents. 
There’s a naming pattern. 
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getting gui 



(retting back to graphics... 

Now that we know a little about how events work (we’ll learn 
more later), let’s get back to putting stuff on the screen. 
We’ll spend a few minutes playing with some fun ways to get 
graphic, before returning to event handling. 

Three ways to put things on your GUI: 

© Put widgets on a frame 

Add buttons, menus, radio buttons, etc. 
frame . getContentPane ( ) . add (myButton) ; 

The javax.swing package has more than a dozen 
widget types. 




© Draw 2D graphics on a widget 

Use a graphics object to paint shapes, 
graphics .fillOval (70,70, 100 , 100) ; 

You can paint a lot more than boxes and circles; 
the Java2D API is full of fun, sophisticated 
graphics methods. 







'it 




Number of Head 
First Java books 
mistakenly 
bought by coffee 
house baristas. 




\ 



tVavV. 

•rS^ 

a<- 



© Put a JPEG on a widget 

You can put your own images on a widget, 
graphics . drawlmage (myPic ,10,10, this) ; 
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making a drawing panel 



Make your own drawing widget 



If you want to put your own graphics on the screen, your best 
bet is to make your own paintable widget. You plop that widget 
on the frame, just like a button or any other widget, but when it 
shows up it will have your images on it. You can even make those 
images move, in an animation, or make the colors on the screen 
change every time you click a button. 

It’s a piece of cake. 

Make a subclass of JPanel and override one 
method, paintComponent(). 

All of your graphics code goes inside the paintComponent() 
method. Think of the paintComponent() method as the method 
called by the system to say, “Hey widget, time to paint yourself.” 
If you want to draw a circle, the paintComponent() method will 
have code for drawing a circle. When the frame holding your 
drawing panel is displayed, paintComponent() is called and your 
circle appears. If the user iconifies/minimizes the window, the 
JVM knows the frame needs “repair” when it gets de-iconified, 
so it calls paintComponent() again. Anytime the JVM thinks the 
display needs refreshing, your paintComponent() method will be 
called. 




One more thing, you never call this method yourself! The argument 
to this method (a Graphics object) is the actual drawing canvas 
that gets slapped onto the real display. You can’t get this by 
yourself; it must be handed to you by the system. You’ll see 
later, however, that you can ask the system to refresh the display 
(repaint()), which ultimately leads to paintComponent() being 

called - . , v ^ 

import j ava . awt . * ; ^ ^ 

— i 

import j avax . swing . * ; ^ 



class MyDrawPanel extends JPanel 






£aasx 



public void paintComponent (Graphics g) { 



g . setColor (Color . orange) ; 



T / ,s \\ Nevw tv,s 

Y°“ l^ v , , "tteve S a ««te 

iftw* ta " S “jtaJ/ot ^ ra V WM ‘ 
draw* - ,I 









J, OY\ *OW- 



g.fillRect (20,50,100,100) 



w . ha ' t s *>ape io pa U fcjuf f nd ! hen 
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getting gui 



Fun things to do in paintComponentO 

Let’s look at a few more things you can do in paintComponent(). 
The most fun, though, is when you start experimenting yourself. 
Try playing with the numbers, and check the API for class 
Graphics (later we’ll see that there’s even more you can do besides 
what’s in the Graphics class) . 



Display a JPEG 



_vJO^ 



$\\e ^ ^ 0tS 






public void paintComponent (Graphics g) { 

Image image = new Imagelcon ("catzilla . jpg") .getlmage () ; 
g . drawlmage ( image ,3,4, this ) ; 






Mi X P*W| 

f he left edge J hl * sa Y s "3 pixels f. 

iop edge J ihe ^,,' r ^ + P*k A* 

^e widge{ ^e «l 




Paint a randomly-colored circle 
on a black background 



public void paintComponent (Graphics g) 







g . fillRect (0,0, this . getWidth ( ) , this . getHeight ( ) ) , 



int red = (int) (Math . random ( ) * 
int green = (int) (Math . random ( ) 
int blue = (int) (Math . random ( ) 



255) ; 

* 255) , 
r 255) ; 



Color randomColor = new Color (red, green, blue) 
g . setColor (randomColor) ; 
g . fillOval (70,70,100,100) ; 

A 

f^{ lO «*.. r 



The Usi Uo av-gs define the U,y) upp et - \ e (± 

XT l ° he P a » el ' *<* '*** drawl 

starts, so OO means "start O pixels Aon, the 9 
le+t edge and O pixels -from the top edge." The 
other two args say, /Hake the width of this 

Zbit e h S W u e (ihis ^0), and 

-«ake the height as tall as the panel (this.heightf 

±°l £ah rna ^e a coloy in, 

e P^«ent the Rtf '» 3 ints 
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drawing gradients with Graphics2D 



Behind every good Graphics reference 
is a Graphics^ object. 

The argument to paintComponent () is declared as type 
Graphics (java.awt. Graphics). 

public void paintComponent (Graphics g) { } 



So the parameter ‘g’ IS-A Graphics object. Which means it 
could be a subclass of Graphics (because of polymorphism) . 

And in fact, it is. 

The object referenced by the ‘g’ parameter is actually an 
instance of the Graphics2D class. 

Why do you care? Because there are things you can do with 
a Graphics 2 D reference that you can’t do with a Graphics 
reference. A Graphics 2 D object can do more than a Graphics 
object, and it really is a Graphics 2 D object lurking behind the 
Graphics reference. 

Remember your polymorphism. The compiler decides which 
methods you can call based on the reference type, not the 
object type. If you have a Dog object referenced by an Animal 
reference variable: 

Animal a = new Dog() ; 

You can NOT say: 

a . bark ( ) ; 

Even though you know it’s really a Dog back there. The 
compiler looks at ‘a’, sees that it’s of type Animal, and finds 
that there’s no remote control button for bark() in the Animal 
class. But you can still get the object back to the Dog it really is 
by saying: 

Dog d = (Dog) a; 
d . bark ( ) ; 

So the bottom line with the Graphics object is this: 

If you need to use a method from the Graphics2D class, you 
can’t use the the paintComponent parameter (‘g’) straight 
from the method. But you can cast it with a new Graphics2D 
variable. 

Graphics2D g2d = (Graphics2D) g; 



Methods you can call on a 
Graphics reference: 

drawlmage() 

drawLine() 

drawPolygon 

drawRect() 

drawOval() 

fill Rect() 

fillRoundRect() 

setColor() 

To cast the Graphics2D object to 
a Graphics2D reference: 

Graphics2D g2d = (Graphics2D) g; 

Methods you can call on 
a Graphics2D reference: 

fill3DRect() 

draw3DRect() 

rotate() 

scale() 

shear() 

transform() 

setRenderingHints() 

(these are v>ot domplete method lists, 
dhedk the API -for more) 
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because life's too short to paint the 
circle a solid color when there's a 
gradient blend waiting for you. 






getting gui 







public void paintComponent (Graphics g) { 
Graphics2D g2d = (Graphics2D) g; 



vt’» ^ a V 



dasi it so we da* dal I something that 
^vayhidsZD has but ^v-ayhids doesn't 



GradientPaint gradient = new GradientPaint (70 , 70 , Color .blue , 150,150, Color . orange) 

s+^_L. f S U -iiy. a y, e^:\ e *di>.. V 



-this zeh l he t 

g2d.setPaint (gradient) ; S^ient instead of s solid dolor ° 
g2d.fillOval (70,70,100,100) ; 



Zlh 9 cd, 



'Of '* d, »3 poi^ 



h 3 col, 



r Oh 



public void paintComponent (Graphics g) { 

Graphics2D g2d = (Graphics2D) g; 

int red = (int) (Math . random ( ) * 255); 
int green = (int) (Math . random ( ) * 255); 
int blue = (int) (Math . random ( ) * 255); 

Color startColor = new Color (red, green, blue); 

red = (int) (Math . random ( ) * 255); 
green = (int) (Math . random ( ) * 255); 
blue = (int) (Math . random ( ) * 255); 

Color endColor = new Color (red, green, blue); 



. <>*e a' 00 ' 1 *’ p 

,Y to\o' rS oK 



GradientPaint gradient = new GradientPaint (70 , 70 , startColor , 150,150, endColor); 
g2d. setPaint (gradient) ; 
g2d.fillOval (70,70,100,100) ; 
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events and graphics 



BULLET POINTS 






EVENTS 

To make a GUI, start with a window, usually a JFrame 

JFrame frame = new JFrame ( ) ; 

You can add widgets (buttons, text fields, etc.) to the 
JFrame using: 

frame . getContentPane () .add (button) ; 

Unlike most other components, the JFrame doesn’t let 
you add to it directly, so you must add to the JFrame’s 
content pane. 

To make the window (JFrame) display, you must give it 
a size and tell it be visible: 
frame . setSize (300 , 300) ; 
frame . setVisible (true) ; 

To know when the user clicks a button (or takes some 
other action on the user interface) you need to listen for 
a GUI event. 

To listen for an event, you must register your interest 
with an event source. An event source is the thing (but- 
ton, checkbox, etc.) that ‘fires’ an event based on user 
interaction. 

The listener interface gives the event source a way 
to call you back, because the interface defines the 
method(s) the event source will call when an event 
happens. 

To register for events with a source, call the source’s 
registration method. Registration methods always take 
the form of: add<EventType>Listener. To register for a 
button’s ActionEvents, for example, call: 

button . addActionListener (this) ; 

Implement the listener interface by implementing all of 
the interface’s event-handling methods. Put your event- 
handling code in the listener call-back method. For 
ActionEvents, the method is: 

public void actionPerf ormed (ActionEvent 

event) { 

button . setText ( "you clicked ! " ) ; 

} 

The event object passed into the event-handler method 
carries information about the event, including the source 
of the event. 



GRAPHICS 

■ You can draw 2D graphics directly on to a widget. 

■ You can draw a .gif or .jpeg directly on to a widget. 

■ To draw your own graphics (including a .gif or .jpeg), 
make a subclass of JPanel and override the paintCom- 
ponent() method. 

■ The paintComponent() method is called by the GUI 
system. YOU NEVER CALL IT YOURSELF. The argu- 
ment to paintComponent() is a Graphics object that 
gives you a surface to draw on, which will end up on 
the screen. You cannot construct that object yourself. 

■ Typical methods to call on a Graphics object (the paint- 
Component paramenter) are: 

graphics . setColor (Color .blue) ; 
g.fillRect(20,50,100,120) ; 

■ To draw a .jpg, construct an Image using: 

Image image = new Imagelcon ("catzilla . 
jpg") .getlmageO ; 
and draw the imagine using: 
g . drawlmage ( image ,3,4, this ) ; 

■ The object referenced by the Graphics parameter 
to paintComponent() is actually an instance of the 
Graphics2D class. The Graphics 2D class has a variety 
of methods including: 

fill3DRect(), draw3DRect(), rotate(), scale(), shear(), 
transform() 

■ To invoke the Graphics2D methods, you must cast the 
parameter from a Graphics object to a Graphics2D 
object: 

Graphics2D g2d = (Graphics2D) g; 
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getting gui 



We can get aw evewt. 

We caw paiwt graphics. 

Pot caw we paiwt graphics wheum get aw evewt? 

Let’s hook up an event to a change in our drawing panel. We’ll make the circle 
change colors each time you click the button. Here’s how the program flows: 



Start the app 

The frame is built with the two widgets 
(your drawing panel and a button). A 
listener is created and registered with 
the button. Then the frame is displayed 
and it just waits for the user to click. 





The user clicks the button and the 
button creates an event object and 
calls the listener's event handler. 



The event handler calls repaint() on the 
frame. The system calls paintComponent() 
on the drawing panel. 




Voila! A new color is painted because 
paintComponent() runs again, filling the 
circle with a random color. 



you are here ► 369 



Head First Java, 2nd Edition. Head First Java, 2nd Edition, ISBN: 0596009208 

Prepared for e.simons@icarin.fiuc.org, Eduard Simons 

Copyright © 2005 Bert Bates and Kathy Sierra. This PDF is made available for personal use only during the relevant subscription term, subject to the Safari Terms of Service. Any other use 
requires prior written consent from the copyright owner. Unauthorized use, reproduction and/or distribution are strictly prohibited and violate applicable laws. All rights reserved. 






building a GUI frame 




to each region of a frame, but don’t panic! That one thing 
might be a panel that holds three other things including a 
panel that holds two more things and... you get the idea. In 
fact, we were ‘cheating’ when we added a button to the frame 
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getting gui 



The circle changes color each time you 
click the button. 



import j avax . swing . * ; 
import j ava . awt . * ; 
import j ava . awt . event . * ; 



public class SimpleGui3C implements ActionListener { 
JFrame frame; 

public static void main ( String [] args) { 
SimpleGui3C gui = new SimpleGui3C ( ) ; 
gui . go ( ) ; 

} 



f «he/ 



A 



^e. 




h «3'oh 



SOUT^ ^ 



public void go() { 

frame = new JFrame () ; 

frame . setDefaultCloseOperation (JFrame . EXIT_ON_CLOSE) ; 



JButton button = new JButton ("Change colors' 
button . addActionListener (this) ; ^ 



) ; 









to ' 



> 



MyDrawPanel drawPanel = new MyDrawPanel ( ) ; 

frame . getContentPane ( ) . add (BorderLayout . SOUTH , 
frame . getContentPane ( ) . add (BorderLayout . CENTER , 
frame . setSize (300 , 300) ; 
frame . setVisible (true) ; 



button) ; ** 
drawPanel) 



— w,a 9«ts (but 

yf r d d ' r * Y,in 5 r**'!) io 

; U the Uo (regions of the 



public void actionPerf ormed (ActionEvent event) { 
frame . repaint ( ) ; 

„J£a * aM <* '•*1 



class MyDrawPanel extends JPanel { 

public void paintComponent (Graphics g) { 

// Code to fill the oval with a random color 
// See page 347 for the code 

} 



} 
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multiple listeners 



Let's try it with TWO buttons 

The south button will act as it does now, simply calling repaint on the 
frame. The second button (which we’ll stick in the east region) will 
change the text on a label. (A label is just text on the screen.) 

So now we need FOUR widgets 





And we need to get 
TWO events 



Uh-oh. 

Is that even possible? How do 
you get two events when you 
have only one actionPerformedQ 
method? 

This button thanes -the te*t 
on -the opposite side 



This button Changes the Color 
the div-dle 
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How do you get action events for two different buttons, 
when each button needs to do something different? 



getting gui 



0 option one 

Implement two actionPerformed() methods 



class MyGui implements ActionListener { 
// lots of code here and then: 



public void actionPerf ormed (ActionEvent event) { 
frame . repaint ( ) ; 




public void actionPerf ormed (ActionEvent event) { 
label . setText ( "That hurt ! " ) ; 



} 



Flaw: You can’t! You can't implement the same method twice in a Java class. It won't compile. 
And even if you could , how would the event source know which of the two methods to call? 



0 option two 

Register the same listener with bpth buttons. 

class MyGui implements ActionListener { 

// declare a bunch of instance variables here 

public void go ( ) { 

// build gui 

colorButton = new JButton ( ) ; 
labelButton = new JButton ( ) : 



Flaw: this does work, but in most cases it’s not very OO. One event handler 
doing many different things means that you have a single method doing many different things. 
If you need to change how one source is handled, you have to mess with everybody's eve nt 
handler. Sometimes it is a good solution, but usually it hurts maintainability and extensibility. 




// more gui code here . . . 



public void actionPerf ormed (ActionEvent event) { 







you are here ► 373 



Head First Java, 2nd Edition. Head First Java, 2nd Edition, ISBN: 0596009208 

Prepared for e.simons@icarin.fiuc.org, Eduard Simons 

Copyright © 2005 Bert Bates and Kathy Sierra. This PDF is made available for personal use only during the relevant subscription term, subject to the Safari Terms of Service. Any other use 
requires prior written consent from the copyright owner. Unauthorized use, reproduction and/or distribution are strictly prohibited and violate applicable laws. All rights reserved. 



multiple listeners 



How do you get action events for two different buttons, 
when each button needs to do something different? 



0 option three 

Create two separate ActionListener classes 

class MyGui { 

JFrame frame; 

JLabel label ; 
void gui () { 

// code to instantiate the two listeners and register one 
// with the color button and the other with the label button 

} 

} // close class 



class ColorButtonListener implements ActionListener { 
public void actionPerf ormed (ActionEvent event) { 
frame . repaint ( ) ; 

) } ^ Wot\{. wovk! This dlass doesn’t have a wtevwte io 

the ^vame variable o£ the d ' ass 



class LabelButtonListener implements ActionListener { 
public void actionPerf ormed (ActionEvent event) { 
label . setText ( "That hurt ! " ) ; 

, 1 ^ r,M'j This *,s to „ a, , JrtaUt w 



Flaw: these classes won’t have access to the variables they need 

to act on, ‘frame’ and ‘label’. You could fix it, but you'd have to give each of the 
listener classes a reference to the main GUI class, so that inside the actionPerformedO 
methods the listener could use the GUI class reference to access the variables of the GUI 
class. But that's breaking encapsulation, so we'd probably need to make getter methods 
for the gui widgets (getFrame(),getLabel(),etc.). And you'd probably need to add a 
constructor to the listener class so that you can pass the GUI reference to the listener at 
the time the listener is instantiated. And, well, it gets messier and more complicated. 

There has got to be a better way! 
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getting gui 




Wouldnt it be wonderful if you ^ 

could have two different listener classes, 
but the listener classes could access the 
instance variables of the main GUI class, 
almost as if the listener classes belonged 
to the other class. Then you'd have the best 
of both worlds. Yeah, that would be dreamy. 
M But it's just a fantasy... 
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inner classes 



Inner class to the rescue! 

You can have one class nested inside another. It’s easy. 
Just make sure that the definition for the inner class is 
inside the curly braces of the outer class. 



Simple inner class: 




O'* 



kJ* ***** 



An inner class gets a special pass to use the outer class’s stuff. Even 
the private stuff. And the inner class can use those private variables 
and methods of the outer class as if the variables and members 
were defined in the inner class. That’s what’s so handy about inner 
classes — they have most of the benefits of a normal class, but with 
special access rights. 

Inner class using an outer class variable 

class MyOuterClass { 
private int x ; 



An inner class can 
use alt the methods 
and variables of the 
outer class, even the 
private ones. 

The inner class gets 
to use those variables 
and methods just 
as if the methods 
and variables were 
declared within the 
inner class. 



i » 
USC * 



class MylnnerClass { 
void go ( ) { 

x = 42; 

} 

} // close inner class 
// close outer class 



as if ‘‘t */eve a vav "‘ a ^ c 

of the nrmev- tlassj 
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getting gui 



Aw inner class Instance most be tied to 
an out er class instance*. 

Remember, when we talk about an inner class accessing 
something in the outer class, we’re really talking about an 
instance of the inner class accessing something in an instance of 
the outer class. But which instance? 



An inner object 
shares a special 
bond with an 
outer object. 



Can any arbitrary instance of the inner class access the methods 
and variables of any instance of the outer class? No! 

An inner object must be tied to a specific outer object on 
the heap. 




(T) Make an instance of 
the outer class 



o 



(2) Make an instance of 
the inner class, by 
using the instance 
of the outer class. 



t 



(^) The outer and inner objects 
are now intimately linked. 



1 Afctt* tv,e *** 

Tv^^ooy . 




iw& 



*There’s an exception to this, for a very special case — an inner class defined 
within a static method. But we’re not going there, and you might go your entire 
Java life without ever encountering one of these. 
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inner class instances 



How to make an instance of an inner class 



If you instantiate an inner class from code within an outer class, the instance 
of the outer class is the one that the inner object will ‘bond’ with. For 
example, if code within a method instantiates the inner class, the inner 
object will bond to the instance whose method is running. 

Code in an outer class can instantiate one of its own inner classes, in exactly 
the same way it instantiates any other class... new My Inner ( ) 



class MyOuter { w a ov-wate 

TV*°^^y 

private int x ; 

Mylnner inner = new Mylnner ( ) ; ^ ^ Make ah ihs-fc^hCe of it 

class hc 



public void doStuff() { 

inner .go () ; ^ ^ a on 

ih^CV’ class 



} 




MyOuter 



class Mylnner { 
void go ( ) { 



x = 42; 



} 



} // close inner class 



} // close outer class 



The method the m<r>ev tlass f« s 
outer class msta«te variable *, as * * 
beloved io tbe mr\CV- class. 



'Side far ‘ 



You can instantiate an inner instance from code running outside the outer class, but you 
have to use a special syntax. Chances are you'll go through your entire Java life and never 
need to make an inner class from outside, but just in case you're interested... 

class Foo { 

public static void main ( String [] args) { 

MyOuter outerOb j = new MyOuter ( ) ; 

MyOuter . Mylnner innerObj = outerOb j. new Mylnner (); 

} 

} 




MyOuter 



Mylnner 
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getting gui 



Now we can get the two-button 
code working , 

LL, _v m 6UI tlass doesn't 



public class TwoButtons { 



JFrame frame; 

JLabel label; 

public static void main (String [] args) { 
TwoButtons gui = new TwoButtons () ; 
gui . go ( ) ; 

} 



public void go() { 

frame = new JFrame ( ) ; 

frame . setDef aultCloseOperation (JFrame . EXIT_ON_CLOSE) ; 



JButton labelButton = new JBut ton ("Change Label") ; 
labelButton . addActionListener (new LabelListener ( ) ) ; 



JButton colorButton = new JButton ("Change Circle") ; 
colorButton . addActionListener (new ColorListener ( ) ) ; 





„ e tV>od, ? assa v ^ ev tlass. 
tV>e afpe-T* 6 » * 



label = new JLabel ("I'm a label"); 
MyDrawPanel drawPanel = new MyDrawPanel ( ) ; 



TwoButtons 

object 



frame . getContentPane ( ) 
frame . getContentPane ( ) 
frame . getContentPane ( ) 
frame . getContentPane ( ) 

frame . setSize (300 , 300) ; 
frame . setVisible (true) ; 



add (BorderLayout . SOUTH , colorButton) ; 
add (BorderLayout . CENTER , drawPanel) ; 
add (BorderLayout . EAST , labelButton) ; 
add (BorderLayout . WEST , label) ; 




class LabelListener implements ActionListener { 
public void actionPerf ormed (ActionEvent event) 
"Ouch ! 



fsio'w Y-e yt '' ave 

kT^ TWO 

a single tiass. 



object 



} 

// 



label . setText ( "Ouch ! " ) ; 

. . ^ irv 

close inner class about 




class ColorListener implements ActionListener 

public void actionPerf ormed (ActionEvent event) 
frame . repaint ( ) ; ^ 

} ihher class 1. u , ,, 

} // close inner class variable w ;lL i i C 

object t ou ^ci r d/ass 
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inner classes 




Head First: What makes inner classes important? 

Inner object: Where do I start? We give you a chance to 
implement the same interface more than once in a class. 
Remember, you can’t implement a method more than 
once in a normal Java class. But using inner classes, each 
inner class can implement the same interface, so you can 
have all these different implementations of the very same 
interface methods. 

Head First: Why would you ever want to implement the 
same method twice? 

Inner object: Let’s revisit GUI event handlers. Think 
about it. . . if you want three buttons to each have a 
different event behavior, then use three inner classes, all 
implementing ActionListener — which means each class 
gets to implement its own actionPerformed method. 

Head First: So are event handlers the only reason to use 
inner classes? 

Inner object: Oh, gosh no. Event handlers are just an 
obvious example. Anytime you need a separate class, but 
still want that class to behave as if it were part of another 
class, an inner class is the best — and sometimes only — way 
to do it. 

Head First: I’m still confused here. If you want the inner 
class to behave like it belongs to the outer class, why have 
a separate class in the first place? Why wouldn’t the inner 
class code just be in the outer class in the first place? 

Inner object: I just gave you one scenario, where you 
need more than one implementation of an interface. But 
even when you’re not using interfaces, you might need 
two different classes because those classes represent two 
different things. It’s good OO. 

Head First: Whoa. Hold on here. I thought a big part of 
OO design is about reuse and maintenance. You know, the 
idea that if you have two separate classes, they can each 
be modified and used independently, as opposed to stuffing 
it all into one class yada yada yada. But with an inner class, 
you’re still just working with one real class in the end, right? 
The enclosing class is the only one that’s reusable and 
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Java Imposed 

This weeks interview: 

Instance of an Inner Class 

separate from everybody else. Inner classes aren’t exactly 
reusable. In fact, I’ve heard them called “Reuseless — 
useless over and over again.” 

Inner object: Yes it’s true that the inner class is not as 
reusable, in fact sometimes not reusable at all, because it’s 
intimately tied to the instance variables and methods of 
the outer class. But it — 

Head First: — which only proves my point! If they’re not 
reusable, why bother with a separate class? I mean, other 
than the interface issue, which sounds like a workaround 
to me. 

Inner object: As I was saying, you need to think about 
IS-A and polymorphism. 

Head First: OK. And I’m thinking about them because... 

Inner object: Because the outer and inner classes 
might need to pass different IS-A tests! Let’s start with the 
polymorphic GUI listener example. What’s the declared 
argument type for the button’s listener registration 
method? In other words, if you go to the API and check, 
what kind of thing (class or interface type) do you have to 
pass to the addActionListenerQ method? 

Head First: You have to pass a listener. Something that 
implements a particular listener interface, in this case 
ActionListener. Yeah, we know all this. What’s your point? 

Inner object: My point is that polymorphically, you have 
a method that takes only one particular type. Something 
that passes the IS-A test for ActionListener. But — and 
here’s the big thing — what if your class needs to be an IS- 
A of something that’s a class type rather than an interface? 

HeadFirst: Wouldn’t you have your class just extend the 
class you need to be a part of? Isn’t that the whole point 
of how subclassing works? If B is a subclass of A, then 
anywhere an A is expected a B can be used. The whole 
pass-a-Dog-where-an-Animal-is-the-declared-type thing. 

Inner object: Yes! Bingo! So now what happens if you 
need to pass the IS-A test for two different classes? Classes 
that aren’t in the same inheritance hierarchy? 
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getting gui 



Head First: Oh, well you just... hmmm. I think I’m get- 
ting it. You can always implement more than one interface, 
but you can extend only one class. You can only be one kind 
of IS-A when it comes to class types. 

Inner object: Well done! Yes, you can’t be both a Dog 
and a Button. But if you’re a Dog that needs to some- 
times be a Button (in order to pass yourself to methods 
that take a Button), the Dog class (which extends Animal 
so it can’t extend Button) can have an inner class that acts 
on the Dog’s behalf as a Button, by extending Button, 
and thus wherever a Button is required the Dog can 
pass his inner Button instead of himself. In other words, 
instead of saying x.takeButton(this), the Dog object calls 
x.takeButton(new MylnnerButtonQ). 

Head First: Gan I get a clear example? 

Inner object: Remember the drawing panel we used, 
where we made our own subclass of JPanel? Right now, 
that class is a separate, non-inner, class. And that’s fine, 
because the class doesn’t need special access to the instance 
variables of the main GUI. But what if it did? What if 
we’re doing an animation on that panel, and it’s getting its 
coordinates from the main application (say, based on some- 
thing the user does elsewhere in the GUI). In that case, if 
we make the drawing panel an inner class, the drawing 
panel class gets to be a subclass of JPanel, while the outer 
class is still free to be a subclass of something else. 

HeadFirst: Yes I see! And the drawing panel isn’t reus- 
able enough to be a separate class anyway, since what it’s 
actually painting is specific to this one GUI application. 

Inner object: Yes! You’ve got it! 

HeadFirst: Good. Then we can move on to the nature of 
the relationship between you and the outer instance. 

Inner object: What is it with you people? Not enough 
sordid gossip in a serious topic like polymorphism? 

HeadFirst: Hey, you have no idea how much the public is 
willing to pay for some good old tabloid dirt. So, someone 
creates you and becomes instantly bonded to the outer 
object, is that right? 

Inner object: Yes that’s right. And yes, some have 
compared it to an arranged marriage. We don’t have a say 
in which object we’re bonded to. 

HeadFirst: Alright, I’ll go with the marriage analogy. 

Can you get a divorce and remarry something else ? 

Inner object: No, it’s for life. 



HeadFirst: Whose life? Yours? The outer object? Both? 

Inner object: Mine. I can’t be tied to any other outer 
object. My only way out is garbage collection. 

HeadFirst: What about the outer object? Can it be 
associated with any other inner objects? 

Inner object: So now we have it. This is what you really 
wanted. Yes, yes. My so-called ‘mate’ can have as many 
inner objects as it wants. 

HeadFirst: Is that like, serial monogamy? Or can it have 
them all at the same time? 

Inner object: All at the same time. There. Satisfied? 

HeadFirst: Well, it does make sense. And let’s not 
forget, it was you extolling the virtues of “multiple 
implementations of the same interface”. So it makes sense 
that if the outer class has three buttons, it would need 
three different inner classes (and thus three different inner 
class objects) to handle the events. Thanks for everything. 
Here’s a tissue. 
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inner classes 



Using an inner class for animation 

We saw why inner classes are handy for event listeners, because 
you get to implement the same event-handling method more 
than once. But now we’ll look at how useful an inner class is when 
used as a subclass of something the outer class doesn’t extend. In 
other words, when the outer class and inner class are in different 
inheritance trees! 

Our goal is to make a simple animation, where the circle moves 
across the screen from the upper left down to the lower right. 

s-tdirt -p'misb 



©00 




©OO 


• 














• 







How simple animation works 

(?) Paint an object at a particular x and y coordinate 



g.fillOval (20 , 50 , 100 , 100) 



i 



2.0 pixels -from -the le-Pt, 

50 pixels -from -the -toy 



(D 



Repaint the object at a different x and y coordinate 
g.fillOval (25 , 55 , 100 , 100) ; 

^ 2-5 pixels -Pv- om the le-Pt, 55 
pixels -Prom the top 



(the objedt moved a little 
down a»d to the ri^ht) 



(3) Repeat the previous step with changing x and y values 
for as long as the animation is supposed to continue. 
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_ t^ereiarerio 

Dumb Questions 

Why are we learning about 
animation here? I doubt if I'm 
going to be making games. 

^V’You might not be making 
games, but you might be 
creating simulations, where 
things change over time to show 
the results of a process. Or you 
might be building a visualization 
tool that, for example, updates 
a graphic to show how much 
memory a program is using, 
or to show you how much 
traffic is coming through 
your load-balancing server. 
Anything that needs to take a 
set of continuously-changing 
numbers and translate them into 
something useful for getting 
information out of the numbers. 

Doesn't that all sound business- 
like? That's just the "official 
justification',' of course. The real 
reason we're covering it here is 
just because it's a simple way 
to demonstrate another use 
of inner classes. (And because 
we just like animation, and our 
next Head First book is about 
J2EE and we know we can't get 
animation in that one.) 
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getting gui 



What we really want is something like... 



class MyDrawPanel extends JPanel { 

public void paintComponent (Graphics g) { 
g . setColor (Color . orange) ; 



} 



.fillOval (x,y , 100 , 100) ; 



- r f i-wf f 




But where do we get the new x and y 
coordinates? 



And who calls repaint()? 

See if you can design a simple solution to get the ball to animate from the top left of the 
drawing panel down to the bottom right. Our answer is on the next page, so don't turn 
this page until you're done! 

Big Huge Hint: make the drawing panel an inner class. 

Another Hint: don't put any kind of repeat loop in the paintComponentO method. 

Write your ideas (or the code) here: 
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animation using an inner class 



The complete simple animation code 

import j avax . swing . * ; 
import j ava . awt . * ; 



public class SimpleAnimation { 




“ v ,, „av'>aW es m 
*• M ^ * a "‘ 1 



public static void main (String [] args) { 

SimpleAnimation gui = new SimpleAnimation () ; 
gui . go ( ) ; 

} 



public void go ( ) { 

JFrame frame = new JFrame() ; 

frame . setDef aultCloseOperation (JFrame . EXIT_ON_CLOSE) ; 



MyDrawPanel drawPanel = new MyDrawPanel ( ) ; 

frame . getContentPane ( ) . add (drawPanel) ; 
frame . setSize (300 ,300) ; 
frame . setVisible (true) ; 



a put >» u e 



widget 



TW«s is >< v ' e ' re 
attio*i 's! 



■tVie 



for (int i = 0; 
x++ ; , 



i < 130; i++) { 



repeat this 160 times 



y++; 



ihdvemeht the x and y 

Loordinaies . , . (so 

.1. 



drawPanel . repaint ( ) ; tcl\ ?*** \ m 

63 * sec t*c W 



try { 

Thread. sleep (50) ; ^ 

} catch (Exception ex) { } 



}// close go() method 



-Slow i* dow« a little (otherwise H will ^ove 
ZreJii7p? 0 ' r '} n '°' lel '"ov-v-y, y 0 u 

JL7 r it°it eady ^ ihis - We> " U t 



to 



** class MyDrawPanel extends JPanel { 






iC< 



public void paintComponent (Graphics g) { 
g. setColor (Color .green) ; 
g.flllOval (x,y ,40, 40) 



} 

} // close inner class 
} // close outer class 



«-di„aW tte' ouW X V 



384 chapter 12 



Head First Java, 2nd Edition. Head First Java, 2nd Edition, ISBN: 0596009208 

Prepared for e.simons@icarin.fiuc.org, Eduard Simons 

Copyright © 2005 Bert Bates and Kathy Sierra. This PDF is made available for personal use only during the relevant subscription term, subject to the Safari Terms of Service. Any other use 
requires prior written consent from the copyright owner. Unauthorized use, reproduction and/or distribution are strictly prohibited and violate applicable laws. All rights reserved. 



Uh-oh. It didn’t move... it smeared. 

What did we do wrong? 



getting gui 



There's one little flaw in the paintComponent() 
method. 

We forgot to erase what was 
already there! So we got trails. 

To fix it, all we have to do is fill in the entire panel with 
the background color, before painting the circle each 
time. The code below adds two lines at the start of the 
method: one to set the color to white (the background 
color of the drawing panel) and the other to fill the 
entire panel rectangle with that color. In English, the 
code below says, “Fill a rectangle starting at x and y of 
0 (0 pixels from the left and 0 pixels from the top) and 
make it as wide and as high as the panel is currently. 




Hoi ex ^'y ih e look 
we 9 oi »3 U. 



public void paintComponent (Graphics g) { 
g. setColor (Color .white) ; 

g . fillRect (0,0, this . getWidth ( ) , this . getHeight ( ) ) ; 




"V T 

g. setColor (Color. green) ; \ l 

g.fillOval (x,y,40,40) ; SraVidtfcO ahd < leffWuO 



Sharpen your pencil (optional, Just for fun] 



What changes would you make to the x and y coordinates to produce the animations below? 
(assume the first one example moves in 3 pixel increments) 



• 




• 


start 


finish 


• 




• 


start 


finish 


• 




• 


start 


finish 



X +1 

Y ±1 

X 

Y 

X 

Y 



• 




• 


start 


finish 






• 


• 






start 


finish 






• 


• 






start 


finish 



X 

Y. 

X 

Y 



X 

Y 
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Code Kitchen 



Code Kitchen 



J 





J3 J 





beat -tKeee beat tow v ... 



Let’s make a music video. We’ll use Java-generated random 
graphics that keep time with the music heats. 

Along the way we’ll register (and listen lor) a new kind ol 
non-GUI event, triggered hy the music itsell. 



Remember, this part is all optional- But we think it’s good -for you. 
And you II like it- And you dan use it to impress people- 

(Ok, sure ; it might work only on people who are really easy to impress, 
but still-) 
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getting gui 



listening for a non-GUI event 



OK, maybe not a music video, but we will make 
a program that draws random graphics on the 
screen with the beat of the music. In a nutshell, 
the program listens for the beat of the music 
and draws a random graphic rectangle with each 
beat. 

That brings up some new issues for us. So far, 
we’ve listened for only GUI events, but now 
we need to listen for a particular kind of MIDI 
event. Turns out, listening for a non-GUI event is 
just like listening for GUI events: you implement 
a listener interface, register the listener with an 
event source, then sit back and wait for the event 
source to call your event-handler method (the 
method defined in the listener interface) . 

The simplest way to listen for the beat of the 
music would be to register and listen for the 
actual MIDI events, so that whenever the 
sequencer gets the event, our code will get it 
too and can draw the graphic. But... there’s a 
problem. A bug, actually, that won’t let us listen 
for the MIDI events ^’remaking (the ones for 
NOTE ON). 

So we have to do a little work-around. There 
is another type of MIDI event we can listen 
for, called a ControllerEvent. Our solution 
is to register for ControllerE vents, and then 
make sure that for every NOTE ON event, 
there’s a matching ControllerEvent fired at 
the same ‘beat’. How do we make sure the 
ControllerEvent is fired at the same time? We 
add it to the track just like the other events! In 
other words, our music sequence goes like this: 

BEAT 1 - NOTE ON, CONTROLLER EVENT 

BEAT 2 - NOTE OFF 

BEAT 3 - NOTE ON, CONTROLLER EVENT 
BEAT 4 - NOTE OFF 
and so on. 

Before we dive into the full program, though, 
let’s make it a little easier to make and add MIDI 
messages/ events since in this program, we’re 
gonna make a lot of them. 



What the music art program 
needs to do: 

(?) Make a series of MIDI messages/ 
events to play random notes on a piano 
(or whatever instrument you choose) 

(2) Register a listener for the events 

(D Start the sequencer playing 

(4) Each time the listener's event 
handler method is called, draw a 
random rectangle on the drawing 
panel, and call repaint. 



We’ll build it in three iterations: 

(?) Version One: Code that simplifies mak- 
ing and adding MIDI events, since we'll 
be making a lot of them. 

(2) Version Two: Register and listen for 
the events, but without graphics. 

Prints a message at the command-line 
with each beat. 

( 4 ) Version Three: The real deal. Adds 
graphics to version two. 
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utility method for events 



An easier way to make 
messages / events 



Right now, making and adding messages and 
events to a track is tedious. For each message, 
we have to make the message instance (in this 
case, ShortMessage) , call setMessage(), make a 
MidiEvent for the message, and add the event 
to the track. In last chapter’s code, we went 
through each step for every message. That 
means eight lines of code just to make a note 
play and then stop playing! Four lines to add a 
NOTE ON event, and four lines to add a NOTE 
OFF event. 

ShortMessage a = new ShortMessage () ; 

a . setMessage (144 , 1 , note, 100); 

MidiEvent noteOn = new MidiEvent (a, 1) ; 
track.add(noteOn) ; 

ShortMessage b = new ShortMessage () ; 

b. setMessage (128 , 1, note, 100); 
MidiEvent noteOff = new MidiEvent (b, 16) ; 
track.add(noteOff ) ; 



Things that have to happen for 
each event: 

(7) Make a message instance 

ShortMessage first = new ShortMessage () ; 

(5) Call setMessage() with the instructions 

first . setMessage (192 , 1, instrument, 0) 

( 3 ) Make a MidiEvent instance for the message 

MidiEvent noteOn = new MidiEvent (first , 1) ; 

(2) Add the event to the track 

track . add (noteOn) ; 



Let’s build a static utility method that The eve ^ ^ 

makes a message and returns a MidiEvent , u, a ,-gumeAs wttBN iw,s Lessau 

- 6 should happen 



{<*■ the ’ 

1 , int c 
whoof A method With r.ve parameters. 



public static MidiEvent makeEvent (int comd, int chan, int one, int two, int tick) { 
MidiEvent event = null; 
try { 

ShortMessage a = new ShortMessage () ; 
a. setMessage (comd, chan, one, two); 
event = new MidiEvent (a, tick) ; 






} catch (Exception e) { } 

return event; ^ ^ ^ ( a divert all 



loaded up with the message) 
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getting gui 



Example: how to use the new static 
makeEventO method 

There’s no event handling or graphics here, just a sequence of 15 
notes that go up the scale. The point of this code is simply to learn 
how to use our new makeEvent() method. The code for the next 
two versions is much smaller and simpler thanks to this method. 



import j avax . sound . midi . * ; 



d °*'i $ 



ike j, 



"»fo^ 



public class MiniMusicPlayerl { 

public static void main (String [] args) { 
try { 

Sequencer sequencer = MidiSystem. getSequencer () ; 
sequencer . open ( ) ; ^ 



„ a V.e °'' >er ' 



■) a se o^rvte< 



Sequence seq = new Sequence ( Sequence . PPQ , 4) ; ^ make d se^ue^de 

Track track = seq . createTrack ( ) ; a *tvadk 

for (int i = 5; i < 61; i+= 4) { — -make a bundh o( events to make the notes keep 

uy (-irrom yiano note to yiano note &I) 



track . add (makeEvent ( 144 , l,i ,100,1) ) ; 
track . add (makeEvent (128,1,1,100,1 + 



2 )) , 



call 



} // end loop 



i i 



^^nning 



sequencer . setSequence (seq) ; 
sequencer . setTempoInBPM (220) ; 
sequencer . start () ; 

} catch (Exception ex) { ex. prints tackTrace (); } 

// close main 



dU ou,r *ew ^akeEv^^O ± L . / 



public static MidiEvent makeEvent (int comd, int chan, int one, int two, int tick) { 
MidiEvent event = null; 
try { 

ShortMessage a = new ShortMessage () ; 
a . setMessage (comd, chan, one, two); 
event = new MidiEvent (a, tick) ; 

} catch (Exception e) { } 
return event; 

} 

} // close class 
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controller events 



Version Two: registering and getting ControllerEvents 



import j avax . sound . midi . * ; 
public class MiniMusicPlayer2 






We need to listen Contvolle'rEvents, 

SO we .element the listener intertaee 



implements ControllerEventListener { 



public static void main (String [] args) { 

MiniMusicPlayer2 mini = new MiniMusicPlayer2 () ; 
mini . go ( ) ; 



} 

public void go() { 
try { 

Sequencer sequencer = MidiSystem. getSequencer () ; 
sequencer . open ( ) ; 



Roister Ekes the 

The event reystrat 



int [ ] events IWant = { 127 } ; 

sequencer . addControllerEventListener (this , eventsIWant) ; 



} 



Sequence seq = new Sequence ( Sequence . PPQ , 4) ; 
Track track = seq . createTrack ( ) ; 



for (int i = 5; i < 60; i+= 4) { 

track. add (makeEvent( 144 ,1,1,100,1) ) 



track. add (makeEvent( 17 6, 1,127,0,1) ) 



track.add(makeEvent(128,l,i,100,i + 2) ) ; 
} // end loop 

sequencer . setSequence (seq) ; 
sequencer . setTempoInBPM (220) ; 
sequencer . start () ; 

} catch (Exception ex) {ex .printStackTrace () ; } 
// close 



type is Controller^ J+) Ti ^ *** eve ^ 
event number iTll jl t«r 

•the N0TB ON Q fT Ch ^ f! 1 * -feidk as 



public void controlChange (ShortMessage event) { 
System. out .println ("la") ; 

} 



t ^ STw we> 






public MidiEvent makeEvent ( int comd, int chan, int one, int two, int tick) { 

MidiEvent event = null ; 
try { 

ShortMessage a = new ShortMessage () ; 
a . setMessage (comd, chan, one, two); 
event = new MidiEvent (a, tick) ; 

Code that's different from the previous 
} catch (Exception e) { } version is highlighted in gray, (and we're 

return event; not running it all within main() this time) 

} 

} // close class 
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getting gui 



Version Three: drawing graphics in time with the music 

This final version builds on version two by adding the GUI parts. We build a 
frame, add a drawing panel to it, and each time we get an event, we draw a 
new rectangle and repaint the screen. The only other change from version 
two is that the notes play randomly as opposed to simply moving up the 
scale. 

The most important change to the code (besides building a simple GUI) 
is that we make the drawing panel implement the ControllerEventListener 
rather than the program itself. So when the drawing panel (an inner class) 
gets the event, it knows how to take care of itself by drawing the rectangle. 

Complete code for this version is on the next page. 



The drawing panel inner class: 






The dvaw' m $ v avvC ' lS a 



class MyDrawPanel extends JPanel implements ControllerEventListener { 

boolean msg = false; — Wcsei, a -flag to -false, and well set it 

to true only when we get ah event 

public void controlChange (ShortMessage event) { 
msg = true; 

repaint () ; ^ j^ e 9°^ an event, so we set the -Plan to 

} true and eall vepaintO 3 



public void pain tComponent (Graphics g) { 
if (msg) { -e * 

Graphics2D g2 = (Graphics2D) g; 



int r = (int) (Math . random ( ) * 250) ; 
int gr = (int) (Math . random ( ) * 250); 

int b = (int) (Math . random ( ) * 250); The rest is todt to generate 

a random dolor and faint a 

g.setColor (new Color (r,gr,b) ) ; semi-random rectangle. 

int ht = (int) ( (Math . random ( ) * 120) + 10); 
int width = (int) ( (Math . random ( ) * 120) + 10); 
int x = (int) ( (Math . random ( ) * 40) + 10); 
int y = (int) ( (Math . random ( ) * 40) + 10); 
g.fillRect (x,y ,ht, width) ; 
msg = false; 



} // close if 
} // close method 
} // close inner class 
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MiniMusicPlayer3 code 




This is the complete code listing for \J^^s\or\ 
Three. It builds directoy on Version Two. Try 
to annotate it yourself, without looking at the 
previous pages. 



import j avax . sound . midi . * ; 
import j ava . io . * ; 
import j avax . swing . * ; 
import j ava . awt . * ; 



public class MiniMusicPlayer3 { 



static JFrame f = new JFrame("My First Music Video") ; 
static MyDrawPanel ml; 

public static void main (String [] args) { 

MiniMusicPlayer3 mini = new MiniMusicPlayer3 () ; 
mini . go ( ) ; 

} // close method 



public void setUpGui() { 
ml = new MyDrawPanel ( ) ; 
f . setContentPane (ml) ; 
f . setBounds (30 , 30 , 300,300); 
f . setVisible (true) ; 

} // close method 

public void go() { 
setUpGui ( ) ; 



Sequencer sequencer = MidiSystem. getSequencer () ; 
sequencer . open ( ) ; 

sequencer . addControllerEventListener (ml , new int[] {127}); 
Sequence seq = new Sequence (Sequence . PPQ, 4) ; 

Track track = seq. createTrack () ; 

int r = 0; 

for (int i = 0; i < 60; i+= 4) { 

r = (int) ( (Math . random ( ) * 50) + 1); 
track. add (makeEvent (144,1, r, 100, i) ) ; 
track . add (makeEvent (176 , 1 , 127 , 0 , i) ) ; 
track . add (makeEvent (128 , 1 , r, 100 , i + 2) ) ; 

} // end loop 

sequencer . setSequence (seq) ; 
sequencer . start ( ) ; 
sequencer . setTempoInBPM( 120) ; 

} catch (Exception ex) {ex.printStackTrace () ; } 

} // close method 



try { 
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getting gui 



public MidiEvent makeEvent (int comd, int chan, int one, int two, int tick) { 
MidiEvent event = null; 
try { 

ShortMessage a = new ShortMessage () ; 
a . setMessage (comd, chan, one, two); 
event = new MidiEvent (a, tick) ; 



} catch (Exception e) { } 
return event; 

} // close method 



class MyDrawPanel extends JPanel implements ControllerEventListener { 
boolean msg = false; 

public void controlChange (ShortMessage event) { 
msg = true; 
repaint () ; 

} 

public void pain tComponent (Graphics g) { 
if (msg) { 

Graphics2D g2 = (Graphics2D) g; 

int r = (int) (Math . random ( ) * 250) ; 
int gr = (int) (Math . random ( ) * 250) ; 
int b = (int) (Math . random ( ) * 250) ; 

g. setColor (new Color (r,gr,b) ) ; 

int ht = (int) ( (Math . random ( ) * 120) + 10); 
int width = (int) ( (Math . random ( ) * 120) + 10) ; 

int x = (int) ( (Math . random ( ) * 40) + 10); 
int y = (int) ( (Math . random ( ) * 40) + 10); 

g.fillRect (x,y ,ht, width); 
msg = false; 

} // close if 
} // close method 
} // close inner class 

} // close class 
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exercise: Who Am I 



A bunch of Java hot-shots, in full costume, are playing the party game"Who 
am I?" They give you a clue, and you try to guess who they are, based on 
what they say. Assume they always tell the truth about themselves. If they 
happen to say something that could be true for more than one guy, then 
write down all for whom that sentence applies. Fill in the blanks next to the 
sentence with the names of one or more attendees. 

Tonight's attendees: 

Any of the charming personalities from this chapter just 
might show up! 



I got the whole GUI, in my hands. 

Every event type has one of these. 

The listener’s key method. 

This method gives JFrame its size. 

You add code to this method but never call it. 

When the user actually does something, it’s an 

Most of these are event sources. 

I carry data back to the listener. 

An addXxxListener( ) method says an object is an 
How a listener signs up. 

The method where all the graphics code goes. 

I’m typically bound to an instance. 

The ‘g’ in (Graphics g), is really of class. 

The method that gets paintComponent( ) rolling. 
The package where most of the Swingers reside. 
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getting gui 




import javax. swing. *; 
import j ava . awt . event . * ; 
import java.awt.*; 

class InnerButton { 

JFrame frame; 

JButton b; 



BE th& compiler 




The Java file on this page represents a 
complete source file. Your job is to play 
compiler and determine whether this file 
will compile. If it won’t compile, how 
would you fix it, and if it does 
compile, what would it do? 



public static void main (String [] args) { 
InnerButton gui = new InnerButton ( ) ; 
gui . go ( ) ; 

} 

public void go() { 
frame = new JFrame(); 
frame . setDef aultCloseOperation ( 

JFrame . EXIT_ON_CLOSE ) ; 

b = new JButton ( "A" ) ; 
b.addActionListener ( ) ; 

frame.getContentPane( ) .add( 

BorderLayout . SOUTH , b ) ; 
frame. setSize(200, 100) ; 
frame . setVisible ( true ) ; 

} 

class BListener extends ActionListener { 

public void actionPerformed(ActionEvent e) { 
if (b.getText( ) .equals ( "A " ) ) { 
b.setText("B" ) ; 

} else { 
b. setText ( "A" ) ; 

} 

} 

} 

> 
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puzzle: Pool Puzzle 




Poo] puzzje 




Your job is to take code snippets from 
the pool and place them into the blank 
lines in the code. You may use the 
same snippet more than once, 
and you won't need to use all the 
snippets. Your goal is to make a 
class that will compile and run 
and produce the output listed. 



import javax. swing. * ; 
import java.awt.*; 
public class Animate { 
int x = 1 ; 
int y = 1; 

public static void main ( String [] args) { 
Animate gui = new Animate ( ) ; 
gui . go ( ) ; 

} 

public void go() { 

JFrame = new JFrame ( ) ; 

frame . setDef aultCloseOperation ( 

JFrame . EXIT_ON_CLOSE ) ; 



Output 

The Amazing, Shrinking, Blue Rectangle. 
This program will produce a blue 
rectangle that will shrink and shrink and 
disappear into a field of white. 



. getContentPane ( ) . add ( drawP ) ; 



. setVisible(true) ; 

for (int i=0; i<124; ) { 




try { 

Thread . sleep (50); 

} catch (Exception ex) { } 

} 

} 

class MyDrawP extends JPanel { 

public void paintComponent (Graphic 

) { 



Note: Each snippet 
from the pool can be 
used more than once! 
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getting gui 



Exercise Solutions 


Who am 1? 




I got the whole GUI, in my hands. 


JFrame 


Every event type has one of these. 


listener interface 


The listener’s key method. 


actionPerformed( ) 


This method gives JFrame its size. 


setSize( ) 


You add code to this method but 
never call it. 


paintComponent( ) 


When the user actually does 
something, it’s an 


event 


Most of these are event sources. 


swing components 


I carry data back to the listener. 


event object 


An addXxxListener( ) method 
says an object is an 


event source 


How a listener signs up. 


addActionListener( ) 


The method where all the 
graphics code goes. 


paintComponent( ) 


I’m typically bound to an instance. 


inner class 


The ‘g’ in (Graphics g), is 
really of this class. 


Graphics2d 


The method that gets 
paintComponent( ) rolling. 


repaint( ) 


The package where most of the 
Swingers reside. 


javax.swing 



BE ih& compiler 



import javax. swing. *; 
import j ava . awt . event . * ; 
import java. awt.*; 

class InnerButton { 

JFrame frame; 

JButton b; 

public static void main (String [] args) { 
InnerButton gui = new InnerButton ( ) ; 
gui. go ( ) ; 

} 

public void go() { 
frame = new JFrame(); 
frame . setDef aultCloseOperation ( 

JFrame . EXIT_ON_CLOSE ) ; 



Once this code 
is fixed, it will 
create a GUI with 
a button that 
toggles between 
A and B when you 
click it. 



The addActionListener( ) 
method takes a class that 
implements the ActionLis- 
tener interface 



b = new JButton ( "A" ) ; 
b . addActionListener ( W6W PUstCWCfl ) ) ; 

frame . getContentPane ( ) . add ( 

BorderLayout . SOUTH , b); 
frame. setSize( 200 ,100) ; 
frame . setVisible ( true ) ; 

} 

class BListener implements ActionListener { 
public void actionPerformed(ActionEvent e) { 
if (b.getText( ) .equals ( "A" ) ) { 
b. setText ( "B" ) ; 

} else { 
b. setText ( "A" ) ; 

} 

} 

} 

} 



ActionListener is an 
interface, interfaces 
are implemented, not 
extended 
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puzzle answers 




Poo] Puzzje 



The Amazing, Shrinking, Blue 
Rectangle. 




import j avax . swing . * ; 
import j ava . awt . * ; 
public class Animate { 
int x = 1 ; 
int y = 1 ; 

public static void main ( String [] args ) { 
Animate gui = new Animate ( ) ; 
gui . go ( ) ; 

} 

public void go( ) { 

JFrame frame = new JFrame(); 
frame . setDef aultCloseOperation ( 

JFrame . EXIT_ON_CLOSE ) ; 

My DrawP drawP = new MyDrawP(); 

frame . getContentPane ( ) . add ( drawP ) ; 

frame.setSize(500,270); 

frame . setVisible ( true ) ; 

for (int i = 0; i < 12 4; i++,X++,y++ ) { 

X++; 

drawP.repain+(); 

try { 

Thread. sleep( 50 ) ; 

} catch (Exception ex) { } 

} 

} 

class MyDrawP extends JPanel { 

public void paintComponent ( Graphics g ) { 

g.setColor(Color.white); 

g.fillRec+(0,0,500,250); 

g.setColor(Color.blue); 

g.fillRect(x/y,500-x*2 / 250-y*2); 

} 

} 

} 
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13 using swing 



Work on Your 
Swing 




Swing is easy. Unless you actually care where things end up on the screen. Swing code 
looks easy, but then you compile it, run it, look at it and think, "hey, that's not supposed to go 
there." The thing that makes it easy to code is the thing that makes it hard to control — the 
Layout Manager. Layout Manager objects control the size and location of the widgets in a 
Java GUI. They do a ton of work on your behalf, but you won't always like the results. You want 
two buttons to be the same size, but they aren't. You want the text field to be three inches long, 
but it's nine. Or one. And under the label instead of next to it. But with a little work, you can get 
layout managers to submit to your will. In this chapter, we'll work on our Swing and in addition 
to layout managers, we'll learn more about widgets. We'll make them, display them (where we 
choose), and use them in a program. It's not looking too good for Suzy. 
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components and containers 



Swing components 

Component 'll the more correct term for what we’ve been calling a widget. 

The things you put in a GUI. The things a user sees and interacts with. Text 
fields, buttons, scrollable lists, radio buttons, etc. are all components. In 
fact, they all extend j avax . swing . JComponent. 

Components can be nested 

In Swing, virtually all components are capable of holding other 
components. In other words, you can stick just about anything into anything 
else. But most of the time, you’ll add user interactive components such as 
buttons and lists into background components such as frames and panels. 
Although it’s possible to put, say, a panel inside a button, that’s pretty 
weird, and won’t win you any usability awards. 

With the exception of JFrame, though, the distinction between interactive 
components and background components is artificial. A JPanel, for 
example, is usually used as a background for grouping other components, 
but even a JPanel can be interactive. Just as with other components, you 
can register for the JPanel’s events including mouse clicks and keystrokes. 

Four steps to making a GUI (review) 

@ Make a window (a JFrame) 

JFrame frame = new JFrame () ; 

@ Make a component (button, text field, etc.) 

JButton button = new JButton ("click me") ; 

@ Add the component to the frame 

frame . getContentPane ( ) . add (BorderLayout . EAST , button) ; 

@ Display it (give it a size and make it visible) 
frame . setSize (300 ,300) ; 
frame . setVisible (true) ; 



A widget is technically 
a Swing Com ponent. 
Almost every thing 
you can stick in a 
GUI extends Irom 
javax.swing. JComponent. 



Put interactive components: 

/ press here ) 



□ choose me JChcCkft 0 * 



This is a text field! 



32 jTe*tP' ,eW 



Into background components: 



900 



Ofy-awe 




JPa«e\ 
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using swing 



Layout Managers 

A layout manager is a Java object associated 
with a particular component, almost always a 
background component. The layout manager 
controls the components contained within the 
component the layout manager is associated 
with. In other words, if a frame holds a panel, 
and the panel holds a button, the panel’s layout 
manager controls the size and placement of 
the button, while the frame’s layout manager 
controls the size and placement of the 
panel. The button, on the other hand, 
doesn’t need a layout manager because the 
button isn’t holding other components. 

If a panel holds five things, even if those 
five things each have their own layout 
managers, the size and location of the five 
things in the panel are all controlled by the 
panel’s layout manager. If those five things, 
in turn, hold other things, then those other 
things are placed according to the layout 
manager of the thing holding them. 



As a layout manager. 

I'm in charge of the size 
and placement of your components. 

In this GUI , I'm the one who decided 
how big these buttons should be, and 
where they are relative to each 
other and the frame. 



eoo 

Fite Panic Deb ate 

fdtck'mT) @ choose me 



When we say hold we really mean add as in, a 
panel holds a button because the button was 
added to the panel using something like: 

my Panel . add (button) ; 

Layout managers come in several flavors, and 
each background component can have its own 
layout manager. Layout managers have their 
own policies to follow when building a layout. 
For example, one layout manager might insist 
that all components in a panel must be the same 
size, arranged in a grid, while another layout 
manager might let each component choose its 
own size, but stack them vertically. Here’s an 
example of nested layouts: 

JPanel panel A = new JPanel ( ) ; 




JPanel pane IB = new JPanel ( ) ; 
panelB . add (new JButton ( "button 1 ") ) ; 
panelB . add (new JButton ( "button 2 " ) ) ; 
panelB . add (new JButton ( "button 3") ) ; 
panel A. add (panelB) ; 
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layout managers 



How does the layout manager decide? 

Different layout managers have different policies for arranging 
components (like, arrange in a grid, make them all the same size, 
stack them vertically, etc.) but the components being layed out do 
get at least some small say in the matter. In general, the process of 

laying out a background component looks something like this: — \ ^ 

Let's see here... the V ^ 

A layout scenario: ( first button wants to be 

f 30 pixels wide, and the text field 

© Make a panel and add three buttons to it. ( nee d s 50, and the frame is 200 pixels 

| wide and I'm supposed to arrange 

® The panel's layout manager asks each button how big V everything vertically... 

that button prefers to be. ^ 

O 

© The panel's layout manager uses its layout policies to decide 
whether it should respect all, part, or none of the buttons' 
preferences. 

@ Add the panel to a frame. 

© The frame's layout manager asks the panel how big the panel 
pref ers to be. 

© The frame's layout manager uses its layout policies to decide 
whether it should respect all, part, or none of the panel's 
preferences. 

Afferent layout managers have different policies 

Some layout managers respect the size the component wants to 
be. If the button wants to be 30 pixels by 50 pixels, that’s what the 
layout manager allocates for that button. Other layout managers 
respect only part of the component’s preferred size. If the button 
wants to be 30 pixels by 50 pixels, it’ll be 30 pixels by however 
wide the button’s background panel is. Still other layout managers 
respect the preference of only the largest of the components 
being layed out, and the rest of the components in that panel 
are all made that same size. In some cases, the work of the layout 
manager can get very complex, but most of the time you can 
figure out what the layout manager will probably do, once you get 
to know that layout manager’s policies. 
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using swing 



The Pig Three layout managers: 
border flow, and box. 



BorderLayout 

A BorderLayout manager divides a background 
component into five regions. You can add only one 
component per region to a background controlled 
by a BorderLayout manager. Components laid out 
by this manager usually don't get to have their 
preferred size. BorderLayout is the default layout 
manager for a frame! 




or>C 

rt$<* 



FlowLayout 

A FlowLayout manager acts kind of like a word 
processor, except with components instead of 
words. Each component is the size it wants to be, 
and they're laid out left to right in the order that 
they're added, with "word-wrap" turned on. So 
when a component won't fit horizontally, it drops 
to the next "line" in the layout. FlowLayout is the 
default layout manager for a panel! 



d DO 

0 <^ l — S) 

ED 



<>p °»ehk added led 
rphi wrapping i 0 a 



BoxLayout 

A BoxLayout manager is like FlowLayout in that 
each component gets to have its own size, and 
the components are placed in the order in which 
they're added. But, unlike FlowLayout, a BoxLayout 
manager can stack the components vertically (or 
horizontally, but usually we're just concerned with 
vertically). It's like a FlowLayout but instead of 
having automatic component wrapping', you can 
insert a sort of component return key' and force 
the components to start a new line. 




to bottom 



added , 
o»t ?er W 
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border layout 




BorderLayout cares 
about five regions: 

east, west, north, 
south, and center 



Let’s add a button to the east region: 

public class Buttonl { 



public static void main (String [] args) { 
Buttonl gui = new Buttonl ( ) ; 
gui . go ( ) ; 

} 



} 






public void go() { 

JFrame frame = new JFrame() ; .- 

JButton button = new JButton ("click me") ; ^ 
frame . getContentPane () . add (BorderLayout . EAST , button) ; 
frame . setSize (200 ,200) ; 
frame . setVisible (true) ; 




=0 

Brain Barbell 



How did the BorderLayout manager come up with 
this size for the button? 



What are the factors the layout manager has to 
consider? 



Why isn't it wider or taller? 
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using swing 



Watch what happens when we give 
the button more characters... 






„ «.****• 



•teA 



public void go ( ) { 

JFrame frame = new JFrameO; 

JButton button = new JButton ("click like you mean it") ; 

frame . getContentPane ( ) . add (BorderLayout . EAST, button); 
frame .setSize(200,200) ; 
frame . setVisible (true) ; 



} 
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border layout 



Let’s try a button in the NORTH region 



public void go ( ) { 

JFrame frame = new JFrameO; 

JButton button = new JButton ("There is no spoon. . .") ; 

frame . getContentPane ( ) . add (BorderLayout .NORTH, button); 
frame . set Size (200 , 200 ) ; 
frame . setVisible (true) ; 



QOO 



There is no spoon... 



La\\ as vt 



Now let’s make the button ask to be ta l ler 

How do we do that? The button is already as wide 
as it can ever be— as wide as the frame. But we 
can try to make it taller by giving it a bigger font. 



public void go ( ) { 

JFrame frame = new JFrameO; 

JButton button = new JButton ("Click This!") ; 

Font bigFont = new Font ("serif " , Font. BOLD, 28); 
button . setFont (bigFont) ; 

frame . getContentPane ( ) . add (BorderLayout . NORTH, button) ; 
frame .set Size (200,200) ; 
frame . setVisible (true) ; 
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using swing 



I think I'm getting it... if I'm in east or 
west, I get my preferred width but the 
height is up to the layout manager. And 
if I'm in north or south, it's just the 
opposite— I get my preferred height, but 
not width. 

O 



^on 



But what happens 
in tke center region? 



The center region gets whatever’s left! 

(except in one special case we’ll look at later) 

public void go() { 

JFrame frame = new JFrame(); 

JButton east = new JButton ("East") ; 
JButton west = new JButton ("West") ; 
JButton north = new JButton ("North") ; 
JButton south = new JButton ("South") ; 
JButton center = new JButton ("Center") ; 



frame . getContentPane ( ) . add (BorderLayout . EAST, east); 
frame . getContentPane ( ) . add (BorderLayout . WEST, west); 
frame . getContentPane ( ) . add (BorderLayout . NORTH, north); 
frame . getContentPane ( ) . add (BorderLayout . SOUTH, south); 
frame . getContentPane ( ) . add (BorderLayout . CENTER, center); 



frame . setSize ( 300 , 300 ) ; 

frame . setVisible (true) ; 
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flow layout 



ao 1 



01^ I v) 




FlowLayout cares 
about the flow of the 
components: 

left to right, top to bottom, in 
the order they were added. 



Let’s add a panel to the east region: 



A JPanel's layout manager is FlowLayout, by default. When we add 
a panel to a frame, the size and placement of the panel is still 
under the BorderLayout manager's control. But anything inside the 
panel (in other words, components added to the panel by calling 
panel . add (aComponent) ) are under the panel's FlowLayout 
manager's control. We'll start by putting an empty panel in the frame's 
east region, and on the next pages we'll add things to the panel. 






import j avax . swing . * ; 
import j ava . awt . * ; 

public class Panell { 

public static void main ( String [] 
Panell gui = new Panell () ; 
gui.go() ; 

} 




public void go() { 

JFrame frame = new JFrame ( ) ; 

JPanel panel = new JPanel ( ) ; 
panel . setBackground (Color . darkGray) , 
frame . getContentPane ( ) . add (BorderLayout . EAST , panel) ; 
frame . setSize (200 , 200) ; 
frame . setVisible (true) ; 



} 



^-Make the P a«el gray so we ear see 
i/ where it is or the -frame. 
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using swing 



Let’s add a button to the panel 



public void go() { 

JFrame frame = new JFrame(); 

JPanel panel = new JPanel(); 

panel . setBackground (Color . darkGray) ; 

JButton button = new JButton ("shock me") , 



i Ll 4-o -the PdttCl ddd 
Add the t ” ( < s layout n>ar>ayv 

?a*d tV>e ari d the W * 

torvUoU the o \ L „| t 4-Ve panel- 



panel . add (button) ; 
frame . getContentPane ( ) . add (BorderLayout . EAST, panel); 



layout 



(Wdev) eo^oUtV*^ 



frame .set Size (250,200) ; 
frame . setVisible (true) ; 





the buttoh got its 
phe+eirired siz< ih both 

beeauselhe P a„ e l 

L S j/ U ,a yyi ahd the 
bu ttoh IS pav-t of XL- , 

Wthe/.ai h 




The frame's 
BorderLayout manager 



The panel's 
FlowLayout manager 
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flow layout 



What happens if we add TWO buttons 
to the panel? 

public void go ( ) { 

JFrame frame = new JFrameO; 

JPanel panel = new JPanelO; 

panel . setBackground (Color . darkGray) ; 

JButton button = new JButton ("shock me") ; 
JButton buttonTwo = new JButton ("bliss" ) ; 



(S' 



*3^ 



TWO 






panel . add (button) ; 
panel . add (buttonTwo) 



- add Both i 0 ihe 



P a»el 



frame . getContentPane ( ) . add (BorderLayout . EAST, panel); 
frame . set Size (250 , 200 ) ; 
frame . setVisible (true) ; 



what we wanted'. 



what we got: 



e o o 




Sharpen your pencil 



V^e ^ 
stat-V-ei 






If the code above were modified to the code below, 
what would the GUI look like? 

JButton button = new JButton ("shock me"); 
JButton buttonTwo = new JButton ("bliss" ) ; 
JButton buttonThree = new JButton ("huh?") ; 
panel . add (button) ; 
panel . add (buttonTwo) ; 
panel . add (buttonThree ) ; 







is wa 'k V ^ 

Q* j 




Draw what you 
thinkthe GUI would 
look like if you ran 
the code to the left. 

(Then try it!) 
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using swing 



BoxLayout to the rescue! 

It keeps components 
stacked, even if there’s room 
to put them side by side. 



Unlike FlowLayout, BoxLayout can force a 
‘new line’ to make the components wrap to 
the next line, even if there’s room for them 
to fit horizontally. 

But now you'll have to change the panel's layout manager from the 
default FlowLayout to BoxLayout. 




public void go ( ) { 

JFrame frame = new JFrame(); 

JPanel panel = new JPanel(); 
panel . setBackground (Color . darkGray) ; 






panel . setLayout (new BoxLayout (panel , BoxLayout . Y_AXIS) ) ; 






JButton button = new JButton ("shock me"); 
JButton buttonTwo = new JButton ("bliss" ) ; 
panel . add (button) ; 
panel . add (buttonTwo) ; 

frame . getContentPane ( ) . add (BorderLayout . EAST, 
frame . set Size (250 , 200 ) ; 
frame . setVisible (true) ; 



I he BoxL ayoJ , 



»"ds to 

y/hidl, axis to IP'P ° Ut ' f ’’ ? 3r 

verti cal zhtkl +«■ a 



panel ) , 




. i u £' rd "' c 

So the 

,o*\V> 'r 00 "' * ' 



: • 
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layout managers 



cJuniL'^uestipns 

% How come you can't add directly to a frame the way 
you can to a panel? 



A JFrame is special because it's where the rubber 
meets the road in making something appear on the screen. 
While all your Swing components are pure Java, a JFrame 
has to connect to the underlying OS in order to access the 
display.Think of the content pane as a 1 00% pure Java layer 
that sits on top of the JFrame. Or think of it as though JFrame 
is the window frame and the content pane is the... glass. You 
know, the window pane. And you can even swap the content 
pane with your own JPanel,to make your JPanel the frame's 
content pane, using, 

myFrame . setContentPane (myPanel) ; 



% Can I change the layout manager of the frame? 
What if I want the frame to use flow instead of border? 

^\^lThe easiest way to do this is to make a panel, build 
the GUI the way you want in the panel, and then make that 
panel the frame's content pane using the code in the previ- 
ous answer (rather than using the default content pane). 



% What if I want a different preferred size? Is there a 
setSize() method for components? 



Yes, there is a setSizeO, but the layout managers will 
ignore it. There's a distinction between the preferred size of 
the component and the size you want it to be. The preferred 
size is based on the size the component actually needs 
(the component makes that decision for itself). The layout 
manager calls the component's getPreferredSizeO method, 
and that method doesn't care if you've previously called 
setSizeQ on the component. 



Can't I just put things where I want them? Can I turn 
the layout managers off? 

Yep. On a component by component basis, you can call 
setLayout (null) and then it's up to you to hard-code 
the exact screen locations and dimensions. In the long run, 
though, it's almost always easier to use layout managers. 
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BULLET POINTS 

■ Layout managers control the size and location of 
components nested within other components. 

■ When you add a component to another component 
(sometimes referred to as a background component, 
but that’s not a technical distinction), the added 
component is controlled by the layout manager of the 
background component. 

■ A layout manager asks components for their 
preferred size, before making a decision about 
the layout. Depending on the layout manager’s 
policies, it might respect all, some, or none of the 
component’s wishes. 

■ The BorderLayout manager lets you add a 
component to one of five regions. You must specify 
the region when you add the component, using the 
following syntax: 

add (BorderLayout . EAST, panel); 

■ With BorderLayout, components in the north and 
south get their preferred height, but not width. 
Components in the east and west get their preferred 
width, but not height. The component in the center 
gets whatever is left over (unless you use pack ( ) ). 

■ The pack() method is like shrink-wrap for the 
components; it uses the full preferred size of the 
center component, then determines the size of the 
frame using the center as a starting point, building 
the rest based on what’s in the other regions. 

■ FlowLayout places components left to right, top to 
bottom, in the order they were added, wrapping to a 
new line of components only when the components 
won’t fit horizontally. 

■ FlowLayout gives components their preferred size in 
both dimensions. 

■ BoxLayout lets you align components stacked 
vertically, even if they could fit side-by-side. Like 
FlowLayout, BoxLayout uses the preferred size of 
the component in both dimensions. 

■ BorderLayout is the default layout manager for a 
frame; FlowLayout is the default for a panel. 

■ If you want a panel to use something other than flow, 
you have to call setLayout ( ) on the panel. 
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using swing 



Playing with Swing components 

You’ve learned the basics of layout managers, so now let’s try out a 
few of the most common components: a text held, scrolling text area, 
checkbox, and list. We won’t show you the whole darn API for each of 
these, just a few highlights to get you started. 



JTextField 




JTextFi'ld 



Constructors 

JTextField field = new JTextField (20) ; 
JTextField field = new JTextField ("Your name") ; 



T w>s u 



How to use it 

© Get text out of it 

System . out . println (field . getText ( ) ) ; 



© Put text in it 



field. setText ("whatever") ; 

field. setTextr^ ^ ^ ^ * ie \d 



© 



Get an ActionEvent when the user 
presses return or enter 



««■ Passes a k e y M * evet 7 Wtl* 



field. addActionListener (myActionListener) ; 



@ Select/Highlight the text in the field 

field. selectAll () ; 

© Put the cursor back in the field (so the user 
can just start typing) 

field. requestFocus () ; 

you are here ► 413 



Head First Java, 2nd Edition. Head First Java, 2nd Edition, ISBN: 0596009208 

Prepared for e.simons@icarin.fiuc.org, Eduard Simons 

Copyright © 2005 Bert Bates and Kathy Sierra. This PDF is made available for personal use only during the relevant subscription term, subject to the Safari Terms of Service. Any other use 
requires prior written consent from the copyright owner. Unauthorized use, reproduction and/or distribution are strictly prohibited and violate applicable laws. All rights reserved. 



text area 



JTextArea 



button clicked 



Unlike JTextField, JTextArea can have more than one line of text. It 
takes a little configuration to make one, because it doesn't come out of 
the box with scroll bars or line wrapping. To make a JTextArea scroll, you 
have to stick it in a ScrollPane. A ScrollPane is an object that really loves 
to scroll, and will take care of the text area's scrolling needs. 

/ . TjO toW" s 

Constructor ^ 

JTextArea text = new JTextArea ( 1 0 , 2 0 ) ; 



How to use it 



© Make it have a vertical scrollbar only 



OStvoWPaf arid \ 0 stvoW W- 

W %**'*** 



JScrollPane scroller = new JScrollPane (text) ; 
text. setLineWrap (true) ; * _ ^ ^ w wa?? m 5 



scroller . setVerticalScrollBar Policy (ScrollPaneConstants . VERT ICAL_SCROLLBAR_ALWAY S ) 
scroller . setHorizontalScrollBar Policy (ScrollPaneConstants . HORI ZONTAL_SCROLLBAR_NEVER) ; 

panel. add ( scrol^JT^ , 

© Replace the text that's in it ^ 

text . setText ("Not all who are lost are wandering"); 



© Append to the text that's in it 

text . append ( "button clicked" ) ; 



@ Select/Highlight the text in the field 

text . selectAll ( ) ; 

© Put the cursor back in the field (so the user 
can just start typing) 

text . requestFocus ( ) ; 
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using swing 



JTextArea example 



import j avax . swing . * ; 
import j ava . awt . * ; 
import j ava . awt . event . * ; 



public class TextAreal implements ActionListener { 
JTextArea text; 

public static void main ( String [] args) { 
TextAreal gui = new TextAreal ( ) ; 
gui.go() ; 

} 



public void go() { 

JFrame frame = new JFrame ( ) ; 

JPanel panel = new JPanel ( ) ; 

JButton button = new JButton (" Just Click It") ; 
button . addActionListener (this) ; 
text = new JTextArea (10 , 20) ; 
text . setLineWrap (true) ; 

JScrollPane scroller = new JScrollPane (text) ; 
scroller . setVerticalScrollBarPolicy (ScrollPaneConstants . VERTICAL_SCROLLBAR_ALWAYS) ; 
scroller . setHorizontalScrollBarPolicy (ScrollPaneConstants . HORI ZONTAL_SCROLLBAR_NEVER) ; 

panel . add (scroller) ; 




frame . getContentPane () . add (BorderLayout . CENTER , panel) ; 
frame . getContentPane ( ) . add (BorderLayout . SOUTH , button) ; 



frame . setSize (350 , 300) ; 
frame . setVisible (true) ; 



public void actionPerf ormed (ActionEvent ev) 
text . append ( "button clicked \n ") ; 



t 






loe 



button clickedbutton clickedbutton clicks 
cdbutton clickedbutton clickedbutton clil 
ckedbutton clickedbutton cHckedbutton c|| 
lukndbutton cHckrdbutton cticktdbuttonl 
clickedbutton clickedbutton cltckedbuttl 
on clickedbutton clickedbutton cltckedbuU 
Mon c 1 \rkedbul Ion clickedbuMon rlickmfl 
T t tton clickedbutton clickcdbutu- 
r^ledbuuon clickedbutton clickedbutton ell * 
rkrdbutton rlickrctoutton clickedbutton c» 
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check box 



JCheckBox 




Constructor 



JCheckBox check = new JCheckBox ("Goes to 11") ; 



How to use it 

© Listen for an item event (when it's selected or deselected) 

check . addltemListener (this) ; 



© Handle the event (and find out whether or not it's selected) 

public void items tateChanged (ItemEvent ev) { 

String onOrOff = "off"; 

if (check. isSelected() ) onOrOff = "on"; 

System. out .println ("Check box is " + onOrOff); 



© Select or deselect it in code 

check . setSelected ( true) ; 
check. setSelected( false) ; 



Dunil-'^uestions 

% Aren't the layout manag- 
ers just more trouble than they're 
worth? If I have to go to all this 
trouble, I might as well just hard- 
code the size and coordinates for 
where everything should go. 

Getting the exact layout 
you want from a layout man- 
ager can be a challenge. But think 
about what the layout manager 
is really doing for you. Even the 
seemingly simple task of figuring 
out where things should go on 
the screen can be complex. For 
example, the layout manager takes 
care of keeping your components 
from overlapping one another. 

In other words, it knows how to 
manage the spacing between 
components (and between the 
edge of the frame). Sure you can 
do that yourself, but what happens 
if you want components to be 
very tightly packed? You might get 
them placed just right, by hand, 
but that's only good for your JVM! 

Why? Because the components 
can be slightly different from 
platform to platform, especially if 
they use the underlying platform's 
native 'look and feel'. Subtle things 
like the bevel of the buttons can 
be different in such a way that 
components that line up neatly 
on one platform suddenly squish 
together on another. 

And we're still not at the really Big 
Thing that layout managers do. 
Think about what happens when 
the user resizes the window! Or 
your GUI is dynamic, where com- 
ponents come and go. If you had 
to keep track of re-laying out all 
the components every time there's 
a change in the size or contents of 
a background component...yikes! 
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using swing 



JList 



e o o 



alpha 

beta 

gamma 

delta 



Constructor 



Jl-isl Cocs-farud-tov Ul. 

^y?e- They don'f have io be ° b J ed £ 

Sfrmj r e L se l , e *?. be S W< but a 

3 P w,|| appeav in ihe u 



String [] listEn tries = {"alpha", "beta", "gamma", "delta", 

"epsilon", "zeta", "eta", "theta "}; 

list = new JList (listEn tries) ; 



How to use it 

© Make it have a vertical scrollbar 



a 



JScrollPane scroller = new JScrollPane (list) ; 

scroller . setVerticalScrollBarPolicy (ScrollPaneConstants . VERTICAL_SCROLLBAR_ALWAYS) ; 
scroller . setHorizontalScrollBarPolicy (ScrollPaneConstants . HORI ZONTAL_SCROLLBAR_NEVER) 

panel . add (scroller) ; 



© Set the number of lines to show before scrolling 

list . setVisibleRowCount ( 4 ) ; 



© Restrict the user to selecting only ONE thing at a time 

list. setSelectionMode (ListSelectionModel . SINGLE_SELECTION) ; 



@ Register for list selection events 

list . addListSelectionListener (this) ; 

© Handle events (find out which thing in the list was selected) 






You’ll yt the ever,- 
put m this i£ test. 



,t TWICE i-f 7 °“ A 0 * ^ 



public void valueChanged (ListSelectionEvent lse) 
if ( Ilse.getValuelsAdjustingO ) { 

String selection = (String) list . getSelectedValue () ; 
System. out .println (selection) ; 



} 



} 



getSeledtedl/alueO actually 

returns an Object A list isn’t 

<»»ited to only String objects. 
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Code Kitchen 





Code Kitchen 




- 




Bass Drum □□□□□□0DDDD0DDDD ( Stan 

Closed Hi-Hat ZZ25ZZZZZZZZZZZZZ / Stop ') 

Open Hi-Hat ZZZZZZZZZZZZZZZZ / ~ q — > 
Acoustic Snare □ Z Z Z Z Z Z Z Z Z Z Z Z Z Z Z , — — . 

Crash Cymbal _ _ g gj Z □□□ g □□□□□□□ Z Tempo Down 
Hand Clap 

High Tom ZZZZZZZZZZZZZZZZ 

Hi Bongo 

Maracas 

Whistle 

Low Conga ZZZZZZZZZZZZZZZZ 
cowbeii □ C 25 Z Z Z □ZZZZZZZZZ 
Vibraslap ZZZZZZZZZZZZZZZZ 
Low-mid Tom ZZZZZZZZZZZZZZZZ 

High Agogo ZZZZZZZZZZZZZZZZ 

Open Hi CongaZ Z Z Z Z Z Z Z Z Z Z _ Z Z Z 



Tltis part’s optional. We’re making tke lull BeatBox, GUI 
anti all. In tke Saving Okjects ckapter, we’ll learn kow to 
save anti restore tlrum patterns. Finally, in tke networking 
ckapter (Make a Connection), we’ll turn tke BeatBox into a 
working ckat client. 
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using swing 



Making the Peat&ox 

This is the full code listing for this version of the BeatBox, with buttons for starting, 
stopping, and changing the tempo. The code listing is complete, and fully- 
annotated, but here’s the overview: 



Build a GUI that has 256 checkboxes (JCheckBox) that start out 
unchecked, 16 labels (JLabel) for the instrument names, and four 
buttons. 

Register an ActionListener for each of the four buttons. We don't 
need listeners for the individual checkboxes, because we aren't 
trying to change the pattern sound dynamically (i.e. as soon as the 
user checks a box). Instead, we wait until the user hits the 'start' 
button, and then walk through all 256 checkboxes to get their state 
and make a MIDI track. 



Set-up the MIDI system (you've done this before) including getting 
a Sequencer, making a Sequence, and creating a track. We are using 
a sequencer method that's new to Java 5.0, setLoopCount( ). This 
method allows you to specify how many times you want a sequence 
to loop. We're also using the sequence's tempo factor to adjust the 
tempo up or down, and maintain the new tempo from one iteration of 
the loop to the next. 



When the user hits 'start', the real action begins. The event-handling 
method for the 'start' button calls the buildTrackAndStart() method. 
In that method, we walk through all 256 checkboxes (one row at 
a time, a single instrument across all 16 beats) to get their state, 
then use the information to build a MIDI track (using the handy 
makeEvent() method we used in the previous chapter). Once the track 
is built, we start the sequencer, which keeps playing (because we're 
looping it) until the user hits 'stop'. 
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BeatBox code 



import j ava . awt . * ; 
import j avax . swing . * ; 
import j avax . sound . midi . * ; 
import j ava . util . * ; 
import j ava . awt . event . * ; 



public class BeatBox { 



JPanel mainPanel ; 

ArrayList< JCheckBox> checkboxList ; 
Sequencer sequencer; 

Sequence sequence ; 

Track track; 

JFrame theFrame ; 



We sieve -the checkboxes m a* AwayL-isi 



These are the names oi ihe insivumenis, as a Siv-'ms 
array, U building ihe <$UI labels U each row) 



String [] instrumentNames = {"Bass Drum", "Closed Hi-Hat", 

"Open Hi-Hat" , "Acoustic Snare", "Crash Cymbal", "Hand Clap", 

"High Tom", "Hi Bongo", "Maracas", "Whistle", "Low Conga", 
"Cowbell", "Vibraslap", "Low-mid Tom", "High Agogo", 

"Open Hi Conga" } ; 

int [ ] instruments = {35,42,46,38,49,39,50,60,70,72,64,56,58,47,67,63}; 



public static void main (String [] args) { 
new BeatBox2 ( ) .buildGUI() ; 

} 



These vepveseni ihe adiual drum 'keys'. 

The dvum channel is like a piano, except 
each key on ihe piano is a differed dr *m. 
So the number Vi is the key (or the Bass 
dvum, 'tZ is Closed tti-Rai, eid 

public void buildGUI() { 

theFrame = new JFrame ("Cyber BeatBox"); 

theFrame . setDef aultCloseOperation (JFrame . EXIT_ON_CLOSE) ; 

BorderLayout layout = new BorderLayout ( ) ; 

JPanel background = new JPanel (layout) ; 

background. setBorder (Border Factory . createEmptyBorder (10 ,10,10,10) ) ; 



checkboxList = new ArrayList<JCheckBox> () ; 

Box buttonBox = new Box (BoxLayout . Y_AXIS) ; 

JButton start = new JButton ("Start") ; 

start . addActionListener (new MyStartListener ( ) ) , 

buttonBox . add (start) ; 






tClXe'dL Tih a T )ih 

where +L, , 9 , the P a "el and 



JButton stop = new JButton ("Stop") ; 

stop . addActionListener (new MyStopListener () ) ; 

buttonBox . add (stop) ; 

JButton upTempo = new JButton ("Tempo Up") ; 
upTempo . addActionListener (new MyUpTempoListener () ) ; 
buttonBox . add (upTempo) ; 



MoiWm^ special here, 

dodc- foreseen most o^.i be W- 



JButton downTempo = new JButton ("Tempo Down") ; 
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using swing 



downTempo . addActionListener (new MyDownTempoListener () ) ; 
buttonBox . add (downTempo) ; 



St.ll m tode 

NotWmJ v-cwdv-kablc- 

theFrame . getContentPane ( ) . add (background) ; 

GridLayout grid = new GridLayout (16 , 16) ; 

grid . setVgap ( 1 ) ; 

grid . setHgap (2 ) ; 

mainPanel = new JPanel (grid) ; 

background . add (BorderLayout . CENTER , mainPanel ) ; 



Box nameBox = new Box (BoxLayout . Y_AXIS) ; 
for (int i = 0; i < 16; i++) { 

nameBox . add (new Label (instrumentNames [i] ) ) ; 

} 

background . add (BorderLayout . EAST , buttonBox) ; 
background. add (BorderLayout .WEST, nameBox) ; 



for (int i = 0; i < 256; i++) { 

JCheckBox c = new JCheckBox ( ) ; 
c. setSelected( false) ; 
checkboxList . add (c) ; 
mainPanel . add (c) ; 

} // end loop 

setUpMidi ( ) ; 



■& tk.. t. 

Jdi Ik. 1 II"? * •"<< 



theFrame . setBounds (50 , 50 , 300 , 300) ; 

theFrame . pack ( ) ; 

theFrame . setVisible (true) ; 

} // close method 



public void setUpMidi ( ) { 

try { 

sequencer = MidiSystem. getSequencer () ; 
sequencer . open ( ) ; 

sequence = new Sequence ( Sequence . PPQ , 4 ) ; 
track = sequence . createTrack ( ) ; 
sequencer . setTempo!nBPM( 120) ; 



fe r' ^T ter ' the 

yatk. nothing spedial. 



} catch (Exception e) {e . printStackTrace () ; } 
} // close method 
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BeatBox code 



TWtS is xheve it all tefpe«s! M** 

v, ihefikW state mto M ' p| evc " u 

a»d add the* to the Tratk- 

public void buildTrackAndStart () { 

int[] trackList = null; 



sequence . dele teTrack (track) ; 
track = sequence . createTrack ( ) ; 



for (int i = 0; i < 16; i++) { 

trackList = new int [16] ; 



, i \a A*e vaWe* . 

*A -f 1 **£*-»* 

- 

play 

\ jrf; via J «* «M - ake a t '“ fc “■ 

w art «* l‘ W* Ba “' <W 



int key = instruments [i] ; ^ U rtfch »*W«U 

for (int j = 0; j < 16; j++ ) { <£-~ p 0 for each of the BEATS for ^ ,s ' ro 

JCheckBox jc = (JCheckBox) checkboxList . get ( j + (16*i) ) ; 
if ( jc . isSelected () ) { 



trackList [j] = key; 
} else { 

trackList [j] = 0; 

} 

} // close inner loop 



|s the dhedkbo* a-t this beat selected? l-f yes, put 
the key value m this slot m the av-v-ay (the slot that 
represents this beat)- Otherwise, the instrument is 
HOT supposed to play at this beat, so set it to zero. 



makeTracks (trackList) ; 
track. add (makeEvent (176, 1,127, 0,16) ) 
} // close outer 



track . add (makeE vent (192 ,9,1,0, 15) ) ; 
try { 



~ Fov this and t* a } l |fc bea ^ 

make events and add the* to the track. 

We always want to make sure that there IS an event at 
beat U> lit goes 0 to 15). Otherwise, the Beatbo* might 
not go the bull It beats before it starts over. 



sequencer . setSequence (sequence) ; 
sequencer . setLoopCount (sequencer . LOOP_CONTINUOUSLY) 
sequencer . start () ; 

sequencer . setTempoInBPM ( 120) ; "\ 

} catch (Exception e) {e .printStackTrace () ; } J 

} // close buildTrackAndStart method 



Lets you spedi-fy the number 
of loop iterations, or in this 
dase, dontinuous looping 



MOW PL AY THE TWt/l 



public class MyStartListener implements ActionListener { 
public void actionPerf ormed (ActionEvent a) { 
buildTrackAndStart () ; 

} 

} // close inner class 



First of ih e inner classes, 
listeners tor the buttons, 
/vothmg special here. 
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using swing 



public class MyStopListener implements ActionListener { 
public void actionPerf ormed (ActionEvent a) { 
sequencer . stop ( ) ; 

} 

} // close inner class 

public class MyUpTempoListener implements ActionListener { 
public void actionPerf ormed (ActionEvent a) { 

float tempoFactor = sequencer . getTempoFactor ( ) ; 
sequencer . setTempoFactor ( (float) (tempoFactor * 1.03)); 

} 

} // close inner class 

public class MyDownTempoListener implements ActionListener { 
public void actionPerf ormed (ActionEvent a) { 
float tempoFactor = sequencer . getTempoFactor ( ) ; 
sequencer . setTempoFactor ( (float) (tempoFactor * .97)); 

} 

} // close inner class 



The o-fcher ihhdr dlass 
lis Ws for the butt™ 



The T empo Fad-tor stales 
ihe se^ue^dev-^ -te**po by 
■the -fad-tor provided. The 
de-fault is 1.0, so w eVe 
adjusting +/ - 3% per 
dlidk. 



public void makeTracks (int [] list) { 

for (int i = 0; i < 16; i++) { 

int key = list[i] ; 

if (key != 0) { 

track . add (makeEvent (144,9, key , 
track . add (makeEvent (128,9, key , 



This makes events w one .nstvument aU 

al ’ |fc beats- So hold cither 

drum, and each mde* m the ar 7 a ^0, 

the kev of that ,nstrument, or a « 

the instrument isn’t T fratk. 

Otherwise, make an event and add «t to the t 



100 , 

100 , 



i)) ; 
i+D) 



Make -the K0TF OK and 
; ? K0T OFF events, and 
add them to the Tradk- 



public MidiEvent makeEvent ( int comd, int chan, int one, int two, int tick) { 
MidiEvent event = null ; 
try { 

ShortMessage a = new ShortMessage () ; 
a. setMessage (comd, chan, one, two); 
event = new MidiEvent (a, tick) ; 

} catch (Exception e) {e . printStackTrace () ; } 
return event; 

} 






hew. 



} // close class 
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exercise: Which Layout? 




Which code goes with 
which layout? 

Five of the six screens below were made from one 
of the code fragments on the opposite page. Match 
each of the five code fragments with the layout that 
fragment would produce. 
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using swing 



Code Fragments 



O JFrame frame = new JFrame ( ) ; 

JPanel panel = new JPanel ( ) ; 

panel . setBackground (Color . darkGray) ; 

JButton button = new JButton ("tesuji") ; 

JButton buttonTwo = new JButton ("watari") ; 

frame . getContentPane ( ) . add (BorderLayout . NORTH , panel ) ; 

panel . add (buttonTwo) ; 

frame . getContentPane ( ) . add (BorderLayout . CENTER , button ) ; 



O JFrame frame = new JFrame () ; 

JPanel panel = new JPanel ( ) ; 

panel . setBackground (Color . darkGray) ; 

JButton button = new JButton ("tesuji") ; 

JButton buttonTwo = new JButton ("watari") ; 
panel . add (buttonTwo) ; 

frame . getContentPane ( ) . add (BorderLayout . CENTER , button) ; 
frame . getContentPane ( ) . add (BorderLayout . EAST , panel ) ; 



ji JFrame frame = new JFrame () ; 

JPanel panel = new JPanel () ; 

panel . setBackground (Color . darkGray) ; 

JButton button = new JButton ("tesuji") ; 

JButton buttonTwo = new JButton ("watari") ; 
panel . add (buttonTwo) ; 

frame . getContentPane ( ) . add (BorderLayout . CENTER , button) ; 



O JFrame frame = new JFrame () ; 

JPanel panel = new JPanel () ; 

panel . setBackground (Color . darkGray) ; 

JButton button = new JButton ("tesuji") ; 

JButton buttonTwo = new JButton ("watari") ; 
panel . add (button) ; 

frame . getContentPane ( ) . add (BorderLayout . NORTH , buttonTwo) ; 
frame . getContentPane ( ) . add (BorderLayout . EAST , panel ) ; 



® JFrame frame = new JFrame () ; 

JPanel panel = new JPanel () ; 

panel . setBackground (Color . darkGray) ; 

JButton button = new JButton ("tesuji") ; 

JButton buttonTwo = new JButton ("watari") ; 

frame . getContentPane ( ) . add (BorderLayout . SOUTH , panel ) ; 

panel . add (buttonTwo) ; 

frame . getContentPane ( ) . add (BorderLayout . NORTH , button) ; 
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puzzle: crossword 
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You can do it. 



Across 

I. Artist's sandbox 

4. Border's catchall 

5. Java look 

9. Generic waiter 

I I. A happening 

12. Apply a widget 

15. JPanel's default 

16. Polymorphic test 



1 7. Shake it baby 
21 . Lots to say 
23. Choose many 

25. Button's pal 

26. Home of 
actionPerformed 



Down 

2. Swing's dad 

3. Frame's purview 

5. Help's home 

6. More fun than text 

7. Component slang 

8. Romulin command 

9. Arrange 

1 0. Border's top 



13. Manager's rules 

14. Source's behavior 

15. Border by default 

1 8. User's behavior 

19. Inner's squeeze 

20. Backstage widget 
22. Mac look 

24. Border's right 



426 chapter 13 



Head First Java, 2nd Edition. Head First Java, 2nd Edition, ISBN: 0596009208 

Prepared for e.simons@icarin.fiuc.org, Eduard Simons 

Copyright © 2005 Bert Bates and Kathy Sierra. This PDF is made available for personal use only during the relevant subscription term, subject to the Safari Terms of Service. Any other use 
requires prior written consent from the copyright owner. Unauthorized use, reproduction and/or distribution are strictly prohibited and violate applicable laws. All rights reserved. 



using swing 



A- 



Exercise Solutions 




O JFrame frame = new JFrame (); 

JPanel panel = new JPanel ( ) ; 

panel . setBackground (Color . darkGray) ; 

JButton button = new JButton ("tesuji") ; 

JButton buttonTwo = new JButton ("watari") ; 
panel . add (buttonTwo) ; 

frame . getContentPane ( ) . add (BorderLayout . CENTER, button) ; 



© 







O JFrame frame = new JFrame() ; 

JPanel panel = new JPanel () ; 

panel . setBackground (Color . darkGray) ; 

JButton button = new JButton ("tesuji") ; 

JButton buttonTwo = new JButton ("watari") ; 

frame . getContentPane ( ) . add (BorderLayout . NORTH , panel ) ; 

panel . add (buttonTwo) ; 

frame . getContentPane () .add (BorderLayout. CENTER, button) ; 




© JFrame frame = new JFrame() ; 

JPanel panel = new JPanel ( ) ; 

panel . setBackground (Color . darkGray) ; 

JButton button = new JButton ("tesuji") ; 

JButton buttonTwo = new JButton ("watari") ; 

frame . getContentPane ( ) . add (BorderLayout . SOUTH , panel ) ; 

panel . add (buttonTwo) ; 

frame .getContentPane () .add (BorderLayout. NORTH, button) ; 




O JFrame frame = new JFrame () ; 

JPanel panel = new JPanel ( ) ; 

panel . setBackground (Color . darkGray) ; 

JButton button = new JButton ("tesuji") ; 

JButton buttonTwo = new JButton ("watari") ; 
panel . add (button) ; 

frame . getContentPane ( ) . add (BorderLayout . NORTH , buttonTwo) ; 
frame . getContentPane ( ) . add (BorderLayout . EAST , panel) ; 



O JFrame frame = new JFrame () ; 

JPanel panel = new JPanel () ; 

panel . setBackground (Color . darkGray) ; 

JButton button = new JButton ("tesuji") ; 

JButton buttonTwo = new JButton ("watari") ; 
panel . add (buttonTwo) ; 

frame . getContentPane ( ) . add (BorderLayout . CENTER, button) ; 
frame . getContentPane ( ) . add (BorderLayout . EAST , panel) ; 
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puzzle answers 




Puzz]e Answers 
(M-Cmss 7.0 
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14 serialization and file I/O 




Objects can be flattened and inflated. Objects have state and behavior. 
Behavior lives in the class, but state lives within each individual object. So what happens when 
it's time to save the state of an object? If you're writing a game, you're gonna need a Save/ 
Restore Game feature. If you're writing an app that creates charts, you're gonna need a Save/ 
Open File feature. If your program needs to save state , you can do it the hard way, interrogating 
each object, then painstakingly writing the value of each instance variable to a file, in a 
format you create. Or, you can do it the easy 00 way — you simply freeze-dry/flatten/persist/ 
dehydrate the object itself, and reconstitute/inflate/restore/rehydrate it to get it back. But you'll 
still have to do it the hard way sometimes, especially when the file your app saves has to be read 
by some other non-Java application, so we'll look at both in this chapter. 
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saving objects 



Capture the Peat 



You’ve made the perfect pattern. You want to save the pattern. 
You could grab a piece of paper and start scribbling it down, but 
instead you hit the Save button (or choose Save from the File 
menu) . Then you give it a name, pick a directory, 
and exhale knowing that your masterpiece won’t go 
out the window with the blue screen of death. 






5 0rurf\ 

:< IK''' 



\ G\o^ 
i Open V 



as^SSg^L 

; °%nnO C O 9 npOO Q 5 n n 

00000^0000^,05 



You have lots of options for how to save the state of \ ^co« sXlC ~ ^ Q Qg p - i 

your Java program, and what you choose will probably \ ctasta nnOO' 99 nnOC 9 ^a ##0 

j 1 — i — — — 1 — ^ — 1 T T \ Hand ^ 



depend on how you plan to i£5£ the saved state. Here 
are the options we’ll be looking at in this chapter. 



If your data will be used by only the Java 
program that generated it: 

© Use serialization 



Q 

^ Hi Bongo 
1 

\ ^bistte 

lL ov* tong* 

\ v\bT^ s ' ap 

diatom 






Write a file that holds flattened (serialized) 
objects. Then have your program read the 
serialized objects from the file and inflate them 
back into living, breathing, heap-inhabiting objects. 



\ LOW- 

\H\9fcM 090 
1 



inO 



Vooq 



o. ... 

Hi Con 9 a 09 — 






npC' 9 ! 



If your data will be used by other programs: 

© Write a plain text file 

Write a file, with delimiters that other programs can parse. 
For example, a tab-delimited file that a spreadsheet or 
database application can use. 



These aren’t the only options, of course. You can save data in any 
format you choose. Instead of writing characters, for example, 
you can write your data as bytes. Or you can write out any kind 
of Java primitive as a Java primitive — there are methods to write 
ints, longs, booleans, etc. But regardless of the method you use, 
the fundamental I/O techniques are pretty much the same: 
write some data to something , , and usually that something is either 
a hie on disk or a stream coming from a network connection. 
Reading the data is the same process in reverse: read some data 
from either a hie on disk or a network connection. And of course 
everything we talk about in this part is for times when you aren’t 
using an actual database. 
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serialization and file I/O 



Saving State 

Imagine you have a program, say, a fantasy 
adventure game, that takes more than one 
session to complete. As the game progresses, 
characters in the game become stronger, weaker, 
smarter, etc., and gather and use (and lose) 
weapons. You don’t want to start from scratch 
each time you launch the game — it took you 
forever to get your characters in top shape for 
a spectacular battle. So, you need a way to save 
the state of the characters, and a way to restore 
the state when you resume the game. And since 
you’re also the game programmer, you want the 
whole save and restore thing to be as easy (and 
foolproof) as possible. 



© Option one 

Write the three serialized 
character objects to a file 

Create a file and write three serialized 
character objects. The file won't make 
sense if you try to read it as text: 

*’ isrGameCharacter 
*' %ge8MUIpowerLjava/lang/ 

String; [weaponst [Ljava/lang/ 
String;xp2tlfur[LjavaJang.String;*“vA 
E { Gxptbowtswordtdustsq~ »tTrolluq~tb 
are handstbig axsq~xtMagicianuq~tspe 
llstinvisibility 

© Option two 

Write a plain text file 

Create a file and write three lines of text, 
one per character, separating the pieces 
of state with commas: 

50, Elf, bow, sword, dust 
200, Troll, bare hands, big ax 
120, Magician, spells, invisibility 



GameCharacter 



int power 
String type 
Weapon[] weapons 



getWeapon() 
useWeaponQ 
increasePower() 
II more 



l 01, 

™ ve three game 
“•ararters to save. 



power: 50 

I | 

weapons: bow, 
sword, dust / 



power: 2-00 \ 

type: Troll 
weapons: bare 
bands, bict a* / 

object 



>bjetf 




the three objects ^ P' ro 9 ' r<3r * to 
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saving objects 



Writing a serialized object to a file 



Here are the steps for serializing (saving) an object. Don’t bother 
memorizing all this; we’ll go into more detail later in this chapter. 



Make a FileOutpu tStrea m 






/ 




FileOutputStream fileS tream = new FileOutputStream ("MyGame . ser") ; 




j ectOutputS tream 



os = new Ob j ectOutputS tream (fileS tream) ; 

tailed tV^ammoj o*>e 




Write the object 

os . writeObject (characterOne) ; 
os .writeObject (characterTwo) ; 
os .writeObject (characterThree) 



, , V-..U y. e { evened ty ^ 

serialises a *d daratWTWee, 

7/ 0«e, patter ' r, e «AfN$a»e*« r 



tV^avattev- 

and 



C lose the ObjectOutputStream 

os . close () 



(dosing tbc sbrea* al -the iov A / L 



ones 
-the 
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serialization and file I/O 



Pata moves m streams from owe place to another. 




Connection 
streams represent 
a connection 
to a source or 
destination (file, 
socket, etc.) while 
chain streams 
cant connect on 
their own and must 
be chained to a 
connection stream. 



The Java I/O API has connection streams, that represent connections to destinations and 
sources such as files or network sockets, and chain streams that work only if chained to 
other streams. 



Often, it takes at least two streams hooked together to do something useful — one to 
represent the connection and another to call methods on. Why two? Because connection 
streams are usually too low-level. FileOutputStream (a connection stream), for example, 
has methods for writing bytes. But we don’t want to write bytesl We want to write objects, so 
we need a higher-level chain stream. 

OK, then why not have just a single stream that does exactly what you want? One that lets 
you write objects but underneath converts them to bytes? Think good OO. Each class 
does one thing well. FileOutputStreams write bytes to a file. ObjectOutputStreams turn 
objects into data that can be written to a stream. So we make a FileOutputStream that lets 
us write to a file, and we hook an ObjectOutputStream (a chain stream) on the end of it. 
When we call writeObject() on the ObjectOutputStream, the object gets pumped into the 
stream and then moves to the FileOutputStream where it ultimately gets written as bytes 
to a file. 



The ability to mix and match different combinations of connection and chain streams 
gives you tremendous flexibility! If you were forced to use only a single stream class, you’d 
be at the mercy of the API designers, hoping they’d thought of everything you might ever 
want to do. But with chaining, you can patch together your own custom chains. 



X 



object is flattened (serialized) 



object is written as bytes to 



o 

Object 



is written to 



is chained to 



ObjectOutputStream 
(a chain stream) 



H 011010010110111001 

FileOutputStream 
(a connection stream) 



01101001 

01101110 

01 

File 
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serialized objects 



What really happens to an object 
when it's serialized? 



Q Object on the heap 




Objects on the heap have state— the 
value of the object's instance 
variables. These values make one 
instance of a class different from 
another instance of the same class. 



@ Object serialized 




Serialized objects save the values 
of the instance variables, so that 
an identical instance (object) can be 
brought back to life on the heap. 






\i& 
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ft 



t*° r 



irvte 



M3V>' 




J he liable values 

+e " r w,dtb ahd I height 

S f ved -file W, 



Foo myFoo = new Foo ( ) 
myFoo . setWidth (37) ; 
myFoo . setHeight (70) ; 



i a l,iie 

2 e °h eci what its 

foo.ser ^' ass "type is). 

FileOutputStream fs = new FileOutputStream("foo . ser" 
ObjectOutputStream os = new Ob jectOutputStream (f s) ; 
os . writeObject (myFoo) ; 

nl i e J'[ e f W ' ^ chab, an 

S e£ S U J PU ^' rea "' io i£ - and Ml the 
ObjectOutputStream to write the object 
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serialization and file I/O 



Pot what exactly ]$ aw object's state? 
What weeds to be saved? 

Now it starts to get interesting. Easy enough to save the primitive 
values 37 and 70 . But what if an object has an instance variable 
that’s an object reference ? What about an object that has five 
instance variables that are object references? What if those object 
instance variables themselves have instance variables? 

Think about it. What part of an object is potentially unique? 
Imagine what needs to be restored in order to get an object that’s 
identical to the one that was saved. It will have a different memory 
location, of course, but we don’t care about that. All we care about 
is that out there on the heap, we’ll get an object that has the same 
state the object had when it was saved. 




Brain Barbell 



What has to happen for the Car 
object to be saved in such a way 
that it can be restored back to its 
original state? 

Think of what — and how — you 
might need to save the Car. 

And what happens if an Engine 
object has a reference to a 
Carburator? And what's inside the 
Tire [] array object? 



The Car object has two 
instance variables that 
reference two other 
objects. 




Oarrol ^ 



c Or ob^ c 



What does it take to 
save a Car object? 
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serialized objects 



When an object is serialized, all the objects 
it refers to from instance variables are also 
serialized. And all the objects those objects 
refer to are serialized. And all the objects those 
objects refer to are serialized... and the best 
part is, it happens automatically! 

This Kennel object has a reference to a Dog [] array object. The 
Dog [] holds references to two Dog objects. Each Dog object holds 
a reference to a String and a Collar object. The String objects 
have a collection of characters and the Collar objects have an int. 

When you save the Kennel, al| of this is saved! 



Serialization saves the 
entire object graph. 
All objects referenced 
by instance variables, 
starting with the 
object being serialized. 



*enne I erf 




°9[ ] arr<xi 



°g obr 
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serialization and file I/O 



If you wan t your class t o be serializable, 
iwplewentr 



Serializable 



The Serializable interface is known as a marker or tog- interface, 
because the interface doesn’t have any methods to implement. Its 
sole purpose is to announce that the class implementing it is, well, 
serializable. In other words, objects of that type are saveable through 
the serialization mechanism. If any superclass of a class is serializable, 
the subclass is automatically serializable even if the subclass doesn’t 
explicitly declare implements Serializable. (This is how interfaces always 
work. If your superclass “IS-A” Serializable, you are too) . 



objectOutputStream. writeOb ject (myBox) 



WV*aW $ oes ^ Jf a »\ at 
0X ' 



aV.zaWe '■ 



■ ike \^ '° ?atkd ^ 

import java.io.*; 

public class Box implements Serializable { 



so 



C e y\ai' z<, ''’“ i. 

-* ** ^ ' N. -w *• 



'private int width; i , 
private int height^/ > these -fcwo values will be 



saved 



public void setWidth(int w) { 
width = w; 

} 

public void setHeight (int h) { 
height = h; 

} 



public static void main (String [] args) { 

Box myBox = new Box ( ) ; 
myBox . se tWidth (50) ; 



... a „ed “too-*® r 

Box myBox = new Box() ; to 3 3 

myBox. setWidth (50); , , s $ * ***• 

myBox. setHeight (20) ; 0?cra W 63* throw eMf ^ v? «t e* ^ oC .ser • 



try { 

FileOutputStream fs = new FileOutputStream ("foo . ser") , 
ObjectOutputStream os = new ObjectOutputStream (fs) ; 
os . wr iteOb j ect (myBox) , 
os . close () ; 

} catch (Exception ex) { 
ex . printStackTrace ( ) , 

} 



Ten i , 

' iio ^ih eohje£i 
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serialized objects 



Serialization is all or nothing. 

Can you imagine what would 
happen if some of the object’s 
state didn’t save correctly? 




import j ava . io . * ; 

public class Pond implements Serializable { 
private Duck duck = new Duck ( ) ; 



Pond objects tar\ be serialized- 



Class Po«a'fr e '" ! 
variable, a 



>sta*te 



public static void main (String [] args) { 

Pond my Pond = new Pond() ; 
try { 

FileOutputStream fs = new FileOutputStream("Pond. ser") ; 
ObjectOutputStream os = new Ob jectOutputStream (f s) ; 



Either the entire 
object graph is 
serialized correctly 
or serialization fails. 

You can’t serialize 
a Pond object if 
its Duck instance 
variable refuses to 
be serialized (by 
not implementing 
Serializable). 



os . writeOb ject (myPond) ; 
os . close () ; 

} catch (Exception ex) { 
ex . printStackTrace ( ) ; 







public class Duck { 
// duck code here 



/'M Duck is noi serializable/ 

It does*, t i»ple»»eirt Serializable, 
SO wbe» yow try to serialize a 
Pond obiedt, it -Pails because the 
Pond s V [Atk ihS-fcan£e variable 
t be saved- 



5 serial, ^d. . D j. 



' “ '* ° t . ..in (P=»<i - 3 *“ ' 13 ' 
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serialization and file I/O 




^ *■ It's hopeless, ^ — 

> then? I'm completely 
screwed if the idiot who 
wrote the class for my instance 
v variable forgot to make it 



Mark an instance variable as transient 
if it can’t (or shouldn’t) be saved. 

If you want an instance variable to be skipped by the 
serialization process, mark the variable with the transient 
keyword. 



If you have an instance variable that can’t be saved because 
it isn’t serializable, you can mark that variable with the 
transient keyword and the serialization process will skip right 
over it. 

So why would a variable not be serializable? It could be 
that the class designer simply forgot to make the class 
implement Serializable. Or it might be because the object 
relies on runtime-specific information that simply can’t be 
saved. Although most things in the Java class libraries are 
serializable, you can’t save things like network connections, 
threads, or hie objects. They’re all dependent on (and 
specific to) a particular runtime ‘experience’. In other words, 
they’re instantiated in a way that’s unique to a particular run 
of your program, on a particular platform, in a particular 
JVM. Once the program shuts down, there’s no way to bring 
those things back to life in any meaningful way; they have to 
be created from scratch each time. 






r .7'* ds pav-t i 

<j the object's siaie * 

du ' r, ^9 serialise*. 



y ! 1 b ' Mved as part 
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serialized objects 



tJierei£ffeiiP 

Dumb Questions 

If serialization is so important, 
why isn't it the default for all classes? 
Why doesn't class Object implement 
Serializable, and then all subclasses 
will be automatically Serializable. 

Even though most classes will, 
and should, implement Serializable, 
you always have a choice. And you 
must make a conscious decision on 
a class-by-class basis, for each class 
you design, to 'enable' serialization 
by implementing Serializable. 

First of all, if serialization were the 
default, how would you turn it off? 
Interfaces indicate functionality, not 
a lack of functionality, so the model 
of polymorphism wouldn't work 
correctly if you had to say, "implements 
NonSerializable"to tell the world that 
you cannot be saved. 



Why would I ever write a class 
that wasn't serializable? 

There are very few reasons, but 
you might, for example, have a security 
issue where you don't want a password 
object stored. Or you might have an 
object that makes no sense to save, 
because its key instance variables are 
themselves not serializable, so there's 
no useful way for you to make your 
class serializable. 



If a class I'm using isn't 
serializable, but there's no good 
reason (except that the designer just 
forgot or was stupid), can I subclass 
the 'bad' class and make the subclass 
serializable? 



Yes! If the class itself is 
extendable (i.e. not final), you can 
make a serializable subclass, and just 
substitute the subclass everywhere 
your code is expecting the superclass 
type. (Remember, polymorphism 
allows this.) Which brings up another 
interesting issue: what does it mean if 
the superclass is not serializable? 

% You brought it up: what does it 
mean to have a serializable subclass 
of a non-serializable superclass? 

First we have to look at what 
happens when a class is deserialized, 
(we'll talk about that on the next few 
pages). In a nutshell, when an object 
is deserialized and its superclass is not 
serializable, the superclass constructor 
will run just as though a new object of 
that type were being created. If there's 
no decent reason for a class to not 
be serializable, making a serializable 
subclass might be a good solution. 

Whoa! I just realized 
something big... if you make a 
variable 'transient', this means the 
variable's value is skipped over 
during serialization. Then what 
happens to it? We solve the problem 
of having a non-serializable instance 
variable by making the instance 
variable transient, but don't we NEED 
that variable when the object is 
brought back to life? In other words, 
isn't the whole point of serialization 
to preserve an object's state? 

Yes, this is an issue, but 
fortunately there's a solution. If you 
serialize an object, a transient reference 
instance variable will be brought back 



as null, regardless of the value it had 
at the time it was saved. That means 
the entire object graph connected to 
that particular instance variable won't 
be saved. This could be bad, obviously, 
because you probably need a non-null 
value for that variable. 

You have two options: 

1 ) When the object is brought back, 
reinitialize that null instance variable 
back to some default state.This 
works if your deserialized object isn't 
dependent on a particular value for 
that transient variable. In other words, 
it might be important that the Dog 
have a Collar, but perhaps all Collar 
objects are the same so it doesn't 
matter if you give the resurrected Dog 
a brand new Collar; nobody will know 
the difference. 

2) If the value of the transient variable 
does matter (say, if the color and design 
of the transient Collar are unique for 
each Dog) then you need to save the 
key values of the Collar and use them 
when the Dog is brought back to 
essentially re-create a brand new Collar 
that's identical to the original. 

What happens if two objects in 
the object graph are the same object? 
Like, if you have two different Cat 
objects in the Kennel, but both Cats 
have a reference to the same Owner 
object. Does the Owner get saved 
twice? I'm hoping not. 

Excellent question! Serialization 
is smart enough to know when two 
objects in the graph are the same. In 
that case, only one of the objects is 
saved, and during deserialization, any 
references to that single object are 
restored. 
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serialization and file I/O 



^serialization: restoring an object 

The whole point of serializing an object is so that you can 
restore it back to its original state at some later date, in a 
different ‘run’ of the JVM (which might not even be the same 
JVM that was running at the time the object was serialized) . 
Deserialization is a lot like serialization in reverse. 




Make a Filelnp utStream 



■ w doesn't 



{ 7 oU 

FilelnputStream fileStream = new FilelnputStream ("MyGame . ser") ; 



iC a* SWt Act 




1 F i<re ^ 



ObjectlnputStream os = new Ob jectlnputStream (fileStream) ; 

Wl >t ta "\ JL to a tonneftio" 




read the objects 



Object one = os . readObject () ; 
Object two = os . readObject () ; 
Object three = os . readObject () ; 



Eadh w v ou , ay readObj ttiO, you «t the »,*+ 

fc : ^ st ^T So ,y-'" btk i* 

Jet l bio 7^ m ' W i iCh ^ we " e You'll 



Cast^the objects 



GameCharacter elf = (GameCharacter) one; 
GameCharacter troll = (GameCharacter) two; 
GameCharacter magician = (GameCharacter) three; 



•L have to asfc * , 






be tf?e Y 01 ' 



JTS^VtreaB Y> s - 



Close the ObjectlnputStream 

os . close () 
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deserializing objects 



What happens during deserialization? 



When an object is deserialized, the JVM attempts to bring 
the object back to life by making a new object on the heap 
that has the same state the serialized object had at the time it 
was serialized. Well, except for the transient variables, which 
come back either null (for object references) or as default 
primitive values. 



01101001 

01101110 

01 



File 



object is read as bytes 



class is found and loaded, saved 
instance variables reassigned 



is read by 



011010010110111001 



is chained to 



FilelnputStream 
(a connection stream) 



ObjectlnputStream 
(a chain stream) 



Object 



Q The object is read from the stream. 

Q The JVM determines (through info stored with 
the serialized object) the object's class type. 

Q The JVM attempts to find and load the ob- 
ject's class. If the JVM can't find and/or load 
the class, the JVM throws an exception and 
the deserialization fails. 

Q A new object is given space on the heap, but 
the serialized object's constructor does 
NOT run! Obviously, if the constructor ran, it 
would restore the state of the object back 
to its original 'new' state, and that's not what 
we want. We want the object to be restored 
to the state it had when it was serialized , not 
when it was first created. 
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serialization and file I/O 



^ If the object has a non-serializable class 
somewhere up its inheritance tree, the 
constructor for that non-serializable class 
will run along with any constructors above 
that (even if they're serializable). Once the 
constructor chaining begins, you can't stop it, 
which means all superclasses, beginning with 
the first non-serializable one, will reinitialize 
their state. 

^ The object's instance variables are given the 
values from the serialized state. Transient 
variables are given a value of null for object 
references and defaults (0, false, etc.) for 
primitives. 



_tJi©reicire^P 

Dumb Questions 



Why doesn't the class get saved as part of the ob- 
ject? That way you don't have the problem with whether 
the class can be found. 



argument,and if the JVM receiving the call doesn't have 
the class, it can use the URL to fetch the class from the 
network and load it, all automatically. (We'll talk about RMI 
in chapter 1 7.) 



A* 

Jr \ m Sure, they could have made serialization work that 
way. But what a tremendous waste and overhead. And 
while it might not be such a hardship when you're using 
serialization to write objects to a file on a local hard drive, 
serialization is also used to send objects over a network 
connection. If a class was bundled with each serialized 
(shippable) object, bandwidth would become a much larger 
problem than it already is. 

For objects serialized to ship over a network, though, there 
actually is a mechanism where the serialized object can be 
'stamped' with a URL for where its class can be found. This 
is used in Java's Remote Method Invocation (RMI) so that 
you can send a serialized object as part of, say, a method 




What about static variables? Are they serialized? 



A- 

Nope. Remember, static means "one per class" not 
"one per object" Static variables are not saved, and when an 
object is deserialized, it will have whatever static variable 
its class currently has. The moral: don't make serializable ob- 
jects dependent on a dynamically-changing static variable! 
It might not be the same when the object comes back. 
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serialization example 



Saving and restoring the game characters 



import java.io.*; 

public class GameSaverTest { Make some ehav-attevs... 

public static void main (String [] args) { 

GameCharacter one = new GameCharacter (50, "Elf", new String!] {"bow", "sword", "dust"}); 
GameCharacter two = new GameCharacter (200, "Troll", new String!] {"bare hands", "big ax"}); 
GameCharacter three = new GameCharacter (120, "Magician", new String!] {"spells", "invisibility"}); 

// imagine code that does things with the characters that might change their state values 



try { 

ObjectOutputStream os = new ObjectOutputStream(new FileOutputStream("Game.ser") ) ; 
os.writeObject(one) ; 
os.writeObject(two) ; 
os. writeObject (three) ; 

os. closed ; 

} catch (IOException ex) { 
ex . prints tackTrace ( ) ; 

} 

one = null ; set then. to 50 ' Mt tan 1 

two = null; attess the objects on the heay- 

three = null; 



Now read then, back in Aon. the -Pile - 

try { l, 

ObjectlnputStream is = new ObjectInputStream(new FileInputStream("Game.ser") ) ; 
GameCharacter oneRestore = (GameCharacter) is.readObjectf); 

GameCharacter twoRestore = (GameCharacter) is.readObjectf); 

GameCharacter threeRestore = (GameCharacter) is.readObjectf); 

l 00 *i£ vt v/ovkcd- 

System. out. println ("One's type: " + oneRestore.getType() ) ; _ to see 

System. out.println ("Two's type: " + twoRestore.getType() ) ; ** 
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serialization and file I/O 



The (raweCharacter class 



import java.io.*; 

public class GameCharacter implements Serializable { 



public int getPower() { 
return power; 

} 

public String getType() { 
return type; 

} 

public String getWeapons() { 

String weaponList = 

for (int i = 0; i < weapons. length; i++) { 
weaponList += weapons [i] + " "; 

} 

return weaponList; 



int power; 

String type; 
String[] weapons; 




public GameCharacter (int p, String t, String!] w) { 
power = p; 
type = t; 
weapons = w; 



you io 
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saving objects 



Object Serialization 



BULLET POINTS 

> You can save an object’s state by serializing the object. 

> To serialize an object, you need an ObjectOutputStream (from the 
java.io package) 

> Streams are either connection streams or chain streams 

> Connection streams can represent a connection to a source or 
destination, typically a file, network socket connection, or the 
console. 

> Chain streams cannot connect to a source or destination and must 
be chained to a connection (or other) stream. 

> To serialize an object to a file, make a FileOuputStream and chain it 
into an ObjectOutputStream. 

> To serialize an object, call writeObject(theObject) on the 
ObjectOutputStream. You do not need to call methods on the 
FileOutputStream. 

> To be serialized, an object must implement the Serializable interface. 
If a superclass of the class implements Serializable, the subclass will 
automatically be serializable even if it does not specifically declare 
implements Serializable. 

> When an object is serialized, its entire object graph is serialized. That 
means any objects referenced by the serialized object’s instance 
variables are serialized, and any objects referenced by those 
objects. ..and so on. 

> If any object in the graph is not serializable, an exception will be 
thrown at runtime, unless the instance variable referring to the object 
is skipped. 

> Mark an instance variable with the transient keyword if you want 
serialization to skip that variable. The variable will be restored as null 
(for object references) or default values (for primitives). 

> During deserialization, the class of all objects in the graph must be 
available to the JVM. 

> You read objects in (using readObject()) in the order in which they 
were originally written. 

> The return type of readObject() is type Object, so deserialized 
objects must be cast to their real type. 

> Static variables are not serialized! It doesn’t make sense to save 
a static variable value as part of a specific object’s state, since all 
objects of that type share only a single value— the one in the class. 
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serialization and file I/O 



Writing a String to a Text File 

Saving objects, through serialization, is the easiest way to save and 

restore data between runnings of a Java program. But sometimes you l/VKat the aarwe dharadter data 

need to save data to a plain old text hie. Imagine your Java program rwijxht look like i-P you wrote it 

has to write data to a simple text hie that some other (perhaps non- ou £ as a hur*an-readable te*t -file- 

Java) program needs to read. You might, for example, have a servlet 
(Java code running within your web server) that takes form data the 
user typed into a browser, and writes it to a text hie that somebody else 
loads into a spreadsheet for analysis. 

Writing text data (a String, actually) is similar to writing an object, 
except you write a String instead of an object, and you use a 
FileWriter instead of a File Outputs tream (and you don’t chain it to an 
ObjectOutputStream) . 

To write a serialized object: 

ObjectOutputStream. writeObject (someObject) ; 

To write a String: 

fileWriter. write ("My first String to save"); 



50, Elf, bow, sword, dust 
200, Troll, bare hands, big ax 
120, Magician, spells, invisibility 



import j ava . io . * ; 






class WriteAFile { 

public static void main (String [] args) { 



a* 



try { 

FileWriter writer = new FileWriter ("Foo . txt") ; 



£ 



n -PooM" doe Y°vt 



writer .write ("hello foo! ") The wv-i ie() method kke 

a String 

writer . close () ; r \ , 

Close «t when you’re done/ 



} catch (IOException ex) { 
ex . prints tackTrace ( ) ; 

} 
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writing a text file 



Text File Fxawple: e-Flashcards 

Remember those flashcards you used in school? Where you 
had a question on one side and the answer on the back? 
They aren’t much help when you’re trying to understand 
something, but nothing beats ‘em for raw drill-and-practice 
and rote memorization. When you have to burn in a fact. And 
they’re also great for trivia games. 

We’re going to make an electronic version that has three 
classes: 

1 ) QuizCardBuilder, a simple authoring tool for creating and 
saving a set of e-Flashcards. 




2) QuizCardPlayer, a playback engine that can load a 
flashcard set and play it for the user. 

3) QuizCard, a simple class representing card data. We’ll 

walk through the code for the builder and the player, and 
have you make the QuizCard class yourself, using this 



e o e 



Quiz Card Builder 



File 



Which university is featured in the 
film "Good Will Hunting'? 



File 



QuizCard 



QuizCard(q, a) 



question 

answer 



getQuestion() 

getAnswer() 



6 0 0 



Quiz Card Player 



What happens if you call 
EJBObject.getPrimaryKeyO on a 
Session bean's remote reference? 



M.I.T 



( Show Answer 



( Next Card ) 



QuizCardBuilder 



QuizCardPlayer 



Has a File menu with a “Save" option for saving 
the current set of cards to a text file. 



Has a File menu with a “Load" option for loading a 
set of cards from a text file. 
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serialization and file I/O 



Quiz Card Guilder (code outline) 



public class QuizCardBuilder j 



public void go() { 

/ / build and display gui 






Irmev dlass 

private class NextCardListener implements ActionListener { ^ ~ 

public void actionPerformed(ActionEvent ev) { Tv'i^evcd “to stove t^at ^vd 

new davd- 



. wfc 'HcA Card’ b«tU: 



/ / add the current card to the list and clear the text areas 



means -the wsev- 
U>e list and start a 



Innen tlass 

private class SaveMenuListener implements ActionListener 
public void actionPerformed(ActionEvent ev) { 

/ / bring up a file dialog box 
/ / let the user name and save the set 



} 



tl * ;r* ^ 



W'ZliKS,? a f * 3 <1** 

Java Ku| es , 'St Set ' Plywood Tnivia, 



|ymev dlass 

private class NewMenuListener implements ActionListener ( 
public void actionPerformed(ActionEvent ev) { 

/ / clear out the card list, and clear out the text areas 



private void saveFile(File file) { 

/ / iterate through the list of cards, and write each one out to a text file 
// in a parseable way (in other words, with clear separations between parts) 

} 

Called by the SaveMenuLisienev; 

does the aetual tile viv-itmj. 
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Quiz Card Builder code 



import java. util.*; 
import java.awt .event.*; 
import javax. swing. *; 
import java.awt.*; 
import java.io.*; 

public class QuizCardBuilder { 

private JTextArea question; 
private JTextArea answer; 
private ArrayList<QuizCard> cardList; 
private JFrame frame; 



public static void main (String [] args) { 

QuizCardBuilder builder = new QuizCardBuilder () ; 
builder .go () ; 

} 



public void go 0 { 

// build gui 

frame = new JFrame ("Quiz Card Builder"); 

JPanel mainPanel = new JPanelO; 

Font bigFont = new Font ("sanserif ", Font. BOLD, 24); 
question = new JTextArea ( 6, 20 ) ; 
question. setLineWrap (true) ; 
question. setWrapStyleWord (true) ; 
question. setFont (bigFont) ; 

JScrollPane qScroller = new JScrollPane (question) ; 
qScroller . setVerticalScrollBarPolicy (ScrollPaneConstants . VERTICAL_SCROLLBAR_ALWAYS) ; 
qScroller . setHorizontalScrollBarPolicy (ScrollPaneConstants . HORIZONTAL_SCROLLBAR_NEVER) ; 

answer = new JTextArea ( 6, 20 ) ; 
answer . setLineWrap (true) ; 
answer . setWrapStyleWord (true) ; 
answer . setFont (bigFont) ; 

JScrollPane aScroller = new JScrollPane (answer) ; 

aScroller. setVerticalScrollBarPolicy (ScrollPaneConstants. VERTICAL_SCROLLBAR_ALWAYS) ; 
aScroller . setHorizontalScrollBarPolicy (ScrollPaneConstants .HORIZONTAL_SCROLLBAR_NEVER) ; 






JButton nextButton = new JButton ("Next Card") ; 

cardList = new ArrayList<QuizCard> ( ) ; 

JLabel qLabel = new JLabel ("Question: ") ; 

JLabel aLabel = new JLabel("Answer:"); 

mainPanel . add (qLabel) ; 
mainPanel . add (qScroller) ; 
mainPanel . add (aLabel) ; 
mainPanel . add (aScroller) ; 
mainPanel . add (nextButton) ; 

nextButton . addActionListener (new NextCardListener ( ) ) ; 
JMenuBar menuBar = new JMenuBar ( ) ; 

JMenu fileMenu = new JMenu ("File") ; 

JMenuItem newMenuItem = new JMenuItem ("New") ; 
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serialization and file I/O 



JMenuItem saveMenuItem = new JMenuItem ("Save") ; 
newMenuItem. addActionListener (new NewMenuListener ( ) ) ; 



saveMenuItem. addActionListener (new SaveMenuListener ( ) ) 
fileMenu. add (newMenuItem) ; 
fileMenu. add (saveMenuItem) ; 
menuBar . add (fileMenu ) ; 
frame . set JMenuBar (menuBar) ; 
frame . getContentPane ( ) . add (BorderLayout . CENTER, mainPanel) 
frame . set Size (500,600); 
frame . setVisible (true) ; 



the* "ft 3 f if « 

i hlo the P i 3hd «v e ' * ehu 

f 3n,e to use this J then tell ^ 



public class NextCardListener implements ActionListener { 

public void actionPerformed (ActionEvent ev) { 

QuizCard card = new QuizCard (question . getText () , answer . getText ()) ; 
cardList . add (card) ; 
clearCard ( ) ; 




public class SaveMenuListener implements ActionListener { 

public void actionPerformed (ActionEvent ev) { 

QuizCard card = new QuizCard (question . getText () , ans 
cardList .add (card) ; 




JFileChooser fileSave = new JFileChooser () ; 

fileSave . showSaveDialog (frame) ; 

saveFile (fileSave . getSelectedFile ( ) ) ; ^ 



getText () ) ; 

. ,v.is or* 



class NewMenuListener implements ActionListen^l: { 

public void actionPerformed (ActionEvent ev) { 
cardList . clear ( ) ; 
clearCard ( ) ; 



3 L *cc ****** 

tu fa ***£ 1 vf 

d'\a\°$' D0 *' C\, etfc- > s ^ 0, ' e * ,1 



private void clearCard () { 
question. setText ("") ; 
answer. setText ("") ; 
question . requestFocus ( ) ; 



l f i\e ^ 

tv. 

We'W * 

'^private void saveFile (File file) 

try { 

Buf feredWriter writer = new Buf feredWriter (new FileWriter (file) ) , 

for (QuizCard card: cardList) { 

writer .write (card. getQuestion ( ) + "/ 
writer .write (card. getAnswer ( ) + "\n") 

} 

writer . close ( ) ; 

} catch (IOException ex) { 

System. out .println ("couldn' t write the cardList out"); 
ex.printStackTrace () ; 





( We’tl talk about thaT^Y”' e((it,eni 
z that '» a -few pa 9 es;. 



JValk the A^ayUt of 

P- W, with 

se P 3 *)ted by a "/" 

add 3 character 'c\’‘) 
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writing files 



The 



java.io.File 



class 



The java.io.File class represents a file on disk, but doesn’t 
actually represent the contents of the file. What? Think of 
a File object as something more like a pathname of a file 
(or even a directory ) rather than The Actual File Itself. 
The File class does not, for example, have methods for 
reading and writing. One VERY useful thing about a File 
object is that it offers a much safer way to represent a 
file than just using a String file name. For example, most 
classes that take a String file name in their constructor 
(like FileWriter or FilelnputStream) can take a File 
object instead. You can construct a File object, verify 
that you’ve got a valid path, etc. and then give that File 
object to the FileWriter or FilelnputStream. 



Some things you can do with a File object: 

© Make a File object representing an 
existing file 

File f = new File("MyCode. txt") ; 



© Make a new directory 

File dir = new File("Chapter7") ; 
dir.mkdir() ; 



@ List the contents of a directory 

if (dir.isDirectory() ) { 

String[] dirContents = dir . list () ; 
for (int i = 0; i < dirContents. length; i++) 
System. out. println (dirContents [i] ) ; 

} 

} 



@ Ge t the absolute path of a file or directory 

System. out. println (dir. getAbsolutePath() ) ; 



© Delete a file or directory (returns true if 
successful) 

boolean isDeleted = f. deleted; 

452 chapter 14 



A File object represents the name 
and path of a file or directory on 
disk, for example: 

/Users/Kathy/Data/GameFile.txt 

But it does NOT represent, or give 
you access to, the data in the file! 



01 . 

J i 
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san . e as tv* a iW . 

house! A F'«' e °^ etl 

' like a street addves^ 
vt 






50, Elf, bow, sword, dust 
200, Troll, bare hands, big ax 
120, Magician, spells, invisibility 
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serialization and file I/O 



The beauty of buffers 

If there were no buffers, it would be like 
shopping without a cart. You'd have to 
carry each thing out to your car, one soup 
can or toilet paper roll at a time. 




W-feirj g ive y , 

r y° u <3 



String is put into a buffer 
with other Strings 



“Boulder” > 

is written to 

String 



“Boulder” “Aspen” 
“Denver” 



When the buffer is full, the 
Strings are all written to 



is chained to 



"Aspen Denver Boulder" 



BufferedWriter 
(a chain stream that 
works with characters) 



FileWriter 
(a connection stream 
that writes characters 
as opposed to bytes) 



X 




File 



BufferedWriter writer = new BufferedWriter (new FileWriter (aFile) ) ; 




The cool thing about buffers is that they’re much more efficient than 
working without them. You can write to a hie using FileWriter alone, by 
calling write (someString) , but FileWriter writes each and every thing you 
pass to the hie each and every time. That’s overhead you don’t want or 
need, since every trip to the disk is a Big Deal compared to manipulating 
data in memory. By chaining a BufferedWriter onto a FileWriter, the 
BufferedWriter will hold all the stuff you write to it until it’s full. Only when 
the buffer is full will the FileWriter actually be told to write to the file on disk. 



a r- 



If you do want to send data before the buffer is full, you do have control. 
Just Flush It. Calls to writer.flush() say, “send whatever’s in the buffer, now\ ” 
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reading files 



Reading from a Text File 

Reading text from a file is simple, but this time we’ll use a File 
object to represent the hie, a FileReader to do the actual reading, 
and a BufferedReader to make the reading more efficient. 

The read happens by reading lines in a while loop, ending the loop 
when the result of a readLine() is null. That’s the most common 
style for reading data (pretty much anything that’s not a Serialized 
object): read stuff in a while loop (actually a while loop test), 
terminating when there’s nothing left to read (which we know 
because the result of whatever read method we’re using is null). 



import j ava . io . 






A -file with two lines o( te*t- 



— 

What’s 2 + 2?/4 
What’s 20+22/42 



MyText.txt 



class ReadAFile { 

public static void main (String [] args) { 
try { 

File myFile = new File ("MyText . txt") ; 



*»*efc* sircar U 
£ uters, ihai tomeeb io a iexi (\\e 



FileReader fileReader = new FileReader (myFile) ; 



BufferedReader reader = new BufferedReader (fileReader) 



V 

String line = null; 






while ((line = reader . readLine () ) != null) 

System. out .println (line) ; 

} % This 

reader . close ( ) ; 



catch (Exception ex) { 
ex . prints tackTrace ( ) ; 



This says, fad a | ihe ^ ^ , 

va ™ble 'line'. W,i I'ihai/^' 5 * * io ih ' 

■ b 'T e , soJihi ft 3 ^ is *<+ 



,me ^ jusi l ”’ 19 lread ^ out ihe 

l ° ' read ' ™d lh°L **** siill | ihes 
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serialization and file I/O 



Quiz Card Player (code outline) 

public class QuizCardPlayer { 

public void go() { 

/ / build and display gui 

} 



class NextCardListener implements ActionListener { 
public void actionPerformed(ActionEvent ev) { 

//if this is a question, show the answer, otherwise show next question 
// set a flag for whether we’re viewing a question or answer 

} 

} 



class OpenMenuListener implements ActionListener { 
public void actionPerformed(ActionEvent ev) { 

/ / bring up a file dialog box 

/ / let the user navigate to and choose a card set to open 

} 



private void loadFile(File file) { 

/ / must build an ArrayList of cards, by reading them from a text hie 
/ / called from the OpenMenuListener event handler, reads the hie one line at a time 
/ / and tells the makeCardQ method to make a new card out of the line 
/ / (one line in the hie holds both the question and answer, separated by a “/”) 

} 



private void makeCard(String lineToParse) { 

/ / called by the loadFile method, takes a line from the text hie 
/ / and parses into two pieces — question and answer — and creates a new QuizCard 
/ / and adds it to the ArrayList called CardList 

} 
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Quiz Card Player code 



import java. util.*; 
import java.awt .event.*; 
import javax. swing. *; 
import java.awt.*; 
import java.io.*; 

public class QuizCardPlayer { 

private JTextArea display; 
private JTextArea answer; 
private ArrayList<QuizCard> cardList; 
private QuizCard currentCard; 

private int currentCardlndex; AH! . . 

private JFrame frame; sp,,nl 0,1 th ' S P a 9«; 

private JButton nextButton; 3 r cc, ol 

private boolean isShowAnswer; 



public static void main (String [] args) { 

QuizCardPlayer reader = new QuizCardPlayer () ; 
reader . go ( ) ; 

} 



public void go() { 

// build gui 

frame = new JFrame ("Quiz Card Player"); 

JPanel mainPanel = new JPanelO; 

Font bigFont = new Font ("sanserif ", Font. BOLD, 24); 

display = new JTextArea (10, 20) ; 
display. setFont (bigFont) ; 

display . setLineWrap (true) ; 
display. setEditable (false) ; 

JScrollPane qScroller = new JScrollPane (display) ; 

qScroller . setVerticalScrollBarPolicy (ScrollPaneConstants . VERTICAL_SCROLLBAR_ALWAYS) ; 
qScroller . setHorizontalScrollBarPolicy (ScrollPaneConstants . HORIZONTAL_SCROLLBAR_NEVER) ; 
nextButton = new JButton ("Show Question"); 
mainPanel . add (qScroller) ; 
mainPanel . add (nextButton) ; 

nextButton . addActionListener (new NextCardListener ( ) ) ; 

JMenuBar menuBar = new JMenuBar ( ) ; 

JMenu fileMenu = new JMenu ("File") ; 

JMenuItem loadMenuItem = new JMenuI tern ("Load card set"); 
loadMenuItem. addActionListener (new OpenMenuListener ( ) ) ; 
fileMenu. add (loadMenuItem) ; 
menuBar . add (fileMenu ) ; 
frame . set JMenuBar (menuBar) ; 

frame . getContentPane ( ) . add (BorderLayout . CENTER, mainPanel); 
frame . set Size (640,500); 
frame . setVisible (true) ; 

} // close go 
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serialization and file I/O 



public class NextCardListener implements ActionListener { 
public void actionPerformed (ActionEvent ev) { 
if (isShowAnswer) { 

// show the answer because they've seen the question 
display . setText (currentCard. getAnswer ()); 
nextButton . setText ("Next Card") ; 
isShowAnswer = false; 

} else { 

// show the next question 
if (currentCardindex < cardList . size ( ) ) { 



showNextCard ( ) ; 
else { 

// there are no more cards! 
display. setText ("That was last card") ; 
nextButton . setEnabled (false) ; 



see * ^9 to 

A ah a ^weir, and do iVT^ a ^ ue ^ ioh 

tU 9 depending Vp a PP< ro P ^ie 






public class OpenMenuListener implements ActionListener 
public void actionPerformed (ActionEvent ev) { 
JFileChooser fileOpen = new JFileChooser () ; 
fileOpen . showOpenDialog (frame) ; 
loadFile (fileOpen . getSelectedFile ( ) ) ; 







private void loadFile (File file) { 



cardList = new ArrayList<QuizCard> ( ) ; 
try { 

BufferedReader reader = new Buf feredReader (new 
String line = null; 

while ((line = reader . readLine () ) != null) { 
makeCard (line) ; 

} 

reader . close ( ) ; 

} catch (Exception ex) { 

System, out .println ("couldn' t read the card file' 
ex .printStackTrace ( ) ; 



// now time to start by showing the first card 
showNextCard ( ) ; 



private void makeCard (String lineToParse) { 

String [] result = lineToParse . split ("/") ; 

QuizCard card = new QuizCard (result [0] , result [1]] 
cardList .add (card) ; 

System. out .println ("made a card") ; 



private void showNextCard ( ) { 

currentCard = cardList . get (currentCardindex) ; 
currentCardIndex++; 

display. setText (currentCard. getQuestion ()); 
nextButton. setText ("Show Answer") ; 
isShowAnswer = true; 

} 

} // close class 



FileReader (file) ) ; 

to a new ** 

W to the ”• , ^ s vt into » 

tsfcsi--***** 



veal o 
^vva^L-lst- 



£adh line ot -bent dovvesponds -bo a single 
•f lashdand, but we have to pa«e out the 
guestion and answer as separate piedes. We 
use the String splitO method to break the 
line into two tokens (one U The guesW 
and one -for the answer). We II look at the 
split.0 method on the ne*t page- 
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parsing Strings with split() 



Parsing with String splitO 

Imagine you have a flashcard like this: 



^ues-bion 



What is 1 


blue + yellow? 


answer 


green 





Saved in a question file like this: 



What is blue + yellow?/green 
What is red + blue?/purple 


1 







How do you separate the question and answer? 

When you read the file, the question and answer are smooshed 
together in one line, separated by a forward slash V" (because 
that's how we wrote the file in the QuizCardBuilder code). 



String split() lets you break a String into pieces. 

The split() method says, "give me a separator, and I'll break out all 
the pieces of this String for you and put them in a String array." 



What is blue ♦ yellow^ Q 




token 1 



separator 



reei^ 

token 2 



String toTest = "What is blue + yellow?/green 
String[] result = toTest. split("/") 
for (String token: result) { 

System. out.pr in tin (token) ; 

> ^ 



. -tv* fii^dPia'r aw, ^ 

|n xnc m | 00 lc s like 

is YiViat. a S1V1 9 * r i-L, jfile. 
yjVien ■i-t’s m frcm tke 

The spli-tO method takes the V" ... / ± 
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serialization and file I/O 



DuWtJuestlQns ^@*1 

OK, I look in the API and there are about five ^ ^ 

million classes in the java.io package. How the heck do - » -I 

you know which ones to use? /V|3K.C It/ 



you 

A. 

^^l-The I/O API uses the modular 'chaining' concept so 
that you can hook together connection streams and chain 
streams (also called 'filter' streams) in a wide range of 
combinations to get just about anything you could want. 

The chains don't have to stop at two levels; you can hook 
multiple chain streams to one another to get just the right 
amount of processing you need. 

Most of the time, though, you'll use the same 
small handful of classes. If you're writing text files, 
BufferedReader and BufferedWriter (chained to FileReader 
and FileWriter) are probably all you need. If you're writing 
serialized objects, you can use ObjectOutputStream and 
ObjectlnputStream (chained to FilelnputStream and 
FileOutputStream). 

In other words, 90% of what you might typically do with 
Java I/O can use what we've already covered. 




% 

A:i 



What about the new I/O nio classes added In 1 .4? 



L-The java. nio classes bring a big performance 
improvement and take greater advantage of native 
capabilities of the machine your program is running 
on. One of the key new features of nio is that you have 
direct control of buffers. Another new feature is non- 
blocking I/O, which means your I/O code doesn't just sit 
there, waiting, if there's nothing to read or write. Some 
of the existing classes (including FilelnputStream and 
FileOutputStream) take advantage of some of the new 
features, under the covers. The nio classes are more 
complicated to use, however, so unless you really need the 
new features, you might want to stick with the simpler 
versions we've used here. Plus, if you're not careful, nio can 
lead to a performance loss. Non-nio I/O is probably right 
for 90% of what you'll normally do, especially if you're just 
getting started in Java. 

But you can ease your way into the nio classes, by using 
FilelnputStream and accessing its channel through the 
getChannelO method (added to FilelnputStream as of 
version 1 .4). 



To write a text file, start with a FileWriter 
connection stream. 

Chain the FileWriter to a BufferedWriter for 
efficiency. 

A File object represents a file at a particular 
path, but does not represent the actual 
contents of the file. 



i a File object you can create, traverse, 
and delete directories. 

Most streams that can use a String filename 
can use a File object as well, and a File object 
can be safer to use. 

To read a text file, start with a FileReader 
connection stream. 

Chain the FileReader to a BufferedReader for 
efficiency. 

To parse a text file, you need to be sure the 
file is written with some way to recognize the 
different elements. A common approach is to 
use some kind of character to separate the 
individual pieces. 

Use the String split() method to split a String 
up into individual tokens. A String with one 
separator will have two tokens, one on each 
side of the separator. The separator doesn’t 
count as a token. 
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saving objects 



Version IP: A Pig Serialization Gotcha 

Now you’ve seen that I/O in Java is actually pretty simple, especially if 
you stick to the most common connection/ chain combinations. But 
there’s one issue you might really care about. 

Version Control is crucial! 

If you serialize an object, you must have the class in order to 
deserialize and use the object. OK, that’s obvious. But what might 
be less obvious is what happens if you change the class in the 
meantime? Yikes. Imagine trying to bring back a Dog object when 
one of its instance variables (non-transient) has changed from a 
double to a String. That violates Java’s type-safe sensibilities in a Big 
Way. But that’s not the only change that might hurt compatibility. 
Think about the following: 



Changes to a class that can hurt deserialization: 

Deleting an instance variable 

Changing the declared type of an instance variable 
Changing a non-transient instance variable to transient 
Moving a class up or down the inheritance hierarchy 

Changing a class (anywhere in the object graph) from Serializable 
to not Serializable (by removing ‘implements Serializable’ from a 
class declaration) 

Changing an instance variable to static 



Changes to a class that are usually OK: 

Adding new instance variables to the class (existing objects will 
deserialize with default values for the instance variables they didn’t 
have when they were serialized) 

Adding classes to the inheritance tree 
Removing classes from the inheritance tree 

Changing the access level of an instance variable has no affect on 
the ability of deserialization to assign a value to the variable 

Changing an instance variable from transient to non-transient 
(previously-serialized objects will simply have a default value for the 
previously-transient variables) 



© You write a Dog class 

dvs ' P 

Dog.class 






101101 
101101 
10101000010 
1010 10 0 
01010 1 
1010101 
10101010 
1001010101 



© 



You serialize a Dog object 
using that class 



C> 

bog obi et 



0 V)\etV>s \ 



© You change the Dog class 

t\ass version |P 

#12-0 



101101 D 
101101 
101000010 
1010 10 o 
01010 1 
100001 1010 
0 00110101 
1 0 1 10 10 



Dog.class 



® You deserialize a Dog object 
using the changed class 



r 

Object >s 
sharped 

version 



101101 
101101 
101000010 
1010 10 0 
01010 1 
100001 1010 
0 00110101 
1 0 1 10 10 



Dog.class 



t\ass verS'O*' ,s 

#110 



© Serailization fails!! 

The JVM says, "you can't 
teach an old Dog new code". 
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serialization and file I/O 



Using the serialVersionUIP 

Each time an object is serialized, the object (including 
every object in its graph) is ‘stamped’ with a version 
ID number for the object’s class. The ID is called 
the serialVersionUID, and it’s computed based on 
information about the class structure. As an object is 
being deserialized, if the class has changed since the 
object was serialized, the class could have a different 
serialVersionUID, and deserialization will fail! But you 
can control this. 

If you think there is ANY possibility that 
your class might evolve , put a serial version 
ID in your class. 

When Java tries to deserialize an object, it compares 
the serialized object’s serialVersionUID with that of the 
class the JVM is using for deserializing the object. For 
example, if a Dog instance was serialized with an ID of, 
say 23 (in reality a serialVersionUID is much longer) , 
when the JVM deserializes the Dog object it will first 
compare the Dog object serialVersionUID with the 
Dog class serialVersionUID. If the two numbers don’t 
match, the JVM assumes the class is not compatible 
with the previously-serialized object, and you’ll get an 
exception during deserialization. 

So, the solution is to put a serialVersionUID 
in your class, and then as the class evolves, the 
serialVersionUID will remain the same and the JVM 
will say, “OK, cool, the class is compatible with this 
serialized object.” even though the class has actually 
changed. 

This works only if you’re careful with your class 
changes! In other words, you are taking responsibility 
for any issues that come up when an older object is 
brought back to life with a newer class. 

To get a serialVersionUID for a class, use the serialver 
tool that ships with your Java development kit. 



% serialver Dog 

Dog: static final long 
serialVersionUID = - 
5849794470654667210L; 



When you think your class 
might evolve after someone has 
serialized objects from it... 

© Use the serialver command-line tool 
to get the version ID for your class 



% serialver Dog 

Dog: static final long 
serialVersionUID = - 
584 97 94 47 0654 6 672 10L; 



( 2 ) Paste the output into your class 
public class Dog { 



static final long serialVersionUID = 
- 684 97 94 47 0754 6 677 10L; 



private String name; 
private int size; 

// method code here 

} 



(3) Be sure that when you make changes to 
the class, you take responsibility in your 
code for the consequences of the changes 
you made to the class! For example, be 
sure that your new Dog class can deal with 
an old Dog being deserialized with default 
values for instance variables added to the 
class after the Dog was serialized. 
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Code Kitchen 





Code Kitcken 





e o e 

Bass Drum 
Closed Hi-Hat 
Open Hi-Hat 
Acoustic Snare 
Crash Cymbal 
Hand Clap 
High Tom 
Hi Bongo 
Maracas 
Whistle 
Low Conga 
Cowbell 
Vibraslap 
Low-mid Tom 
High Agogo 
Open Hi Conga 



Cyber SeatBox 

□ □□□□□ aaoa c an 

□ CV stop ) 

□□□□□□□□□DDOGnao>==^ 

z □ □ □ □□□□□□ □ □ □ □ c z ; y 

zzagszzzz^zzzzzzz 1 Tem p° Dow n - 

□ □ □ □ □ Z □ □ □ Z Z □ Z Z Z Z C serialize V 

aZDODODO □□□□□□□□ ( restore ) ^ 

□□□□□□ QODOOO DO DO 
z z z z z z z a zzzzzzzz 
□□□□□□□□□□□□□□□a 
□□□□□□□□□□□□□□□□ 
z z ^ z z □□□zaaan □ ^ _ 
z □ z z z □ z □ z □ a □ z z z □ 
z z z z z z z z z z z z z z a z 
zazzzazzzzzazzzz 
□□□□□oz □□□□□□□□ 



1 A\tV ’ 

U*e tuvvemt ?a 
fee saved- 

patter back in, and ^ eseh 

the checkboxes. 



Let’s make tke BeatBox save anti 
restore our favorite pattern 
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serialization and file I/O 



Saving a Peat&ox pattern 

Remember, in the BeatBox, a drum pattern is nothing more than a bunch of 
checkboxes. When it’s time to play the sequence, the code walks through the 
checkboxes to figure out which drums sounds are playing at each of the 16 
beats. So to save a pattern, all we need to do is save the state of the checkboxes. 

We can make a simple boolean array, holding the state of each of the 256 
checkboxes. An array object is serializable as long as the things in the array are 
serializable, so we’ll have no trouble saving an array of booleans. 

To load a pattern back in, we read the single boolean array object (deserialize 
it), and restore the checkboxes. Most of the code you’ve already seen, in the 
Code Kitchen where we built the BeatBox GUI, so in this chapter, we look at 
only the save and restore code. 

This CodeKitchen gets us ready for the next chapter, where instead of writing 
the pattern to a file, we send it over the network to the server. And instead of 
loading a pattern in from a file, we get patterns from the server, each time a 
participant sends one to the server. 



Serializing a pattern 

This is an inner class inside 
•the BeatfW code- 

public class MySendListener implements ActionListener { 
public void actionPerf ormed (ActionEvent a) { ^ — - - 
boolean [] checkboxState = new boolean [256] ; ^ — 
for (int i = 0; i < 256; i++) { 



It all happens xhen the «sen tlitks the 
button and the ActionEvent tmes. 



JCheckBox check = (JCheckBox) checkboxList . get (i) ; ^ 

if (check . isSelected() ) { 



checkboxState [i] = true; 



} 






dtirdy. 



try { 

FileOutputStream fileStream = new FileOutputStream (new File ("Checkbox . ser") ) ; 
ObjectOutputStream os = new Ob jectOutputStream (fileStream) ; 
os . writeObject (checkboxState) ; 

} catch (Exception ex) { 
ex . prints tackTrace ( ) ; 



Thi f a piece of cake 

.tty 



} // close method 
} // close inner class 
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deserializing the pattern 



Restoring a Peat&ox pattern 

This is pretty much the save in reverse... read the boolean array and use it 
to restore the state of the GUI checkboxes. It all happens when the user hits 
the “restore” ‘button. 



Restoring a pattern 



This is ano-fchev iw>ev tlass 
inside -the Bea-tfco* tla»- 



public class MyReadlnListener implements ActionListener { 



public void actionPerf ormed (ActionEvent a) { 
boolean [] checkboxState = null; 
try { 

FilelnputStream fileln = new FilelnputStr earn (new File ("Checkbox . ser") ) ; 
ObjectlnputStream is = new ObjectlnputStream (fileln) ; 

checkboxState = (boolean []) is . readObject () ; ^ p i j_i . sm<\lc obvct'b m vile ttne 

|\Cd» vne n J , .1 i ^1/ 4-0 a 



} catch (Exception ex) {ex .printStackTrace ( ) ; } 



boolean avvav («»e»beir, r&AO j 

a v-elev-ente of type fet 



for (int i = 0; i < 256; i++) { 
JCheckBox check = (JCheckBox) 
if (checkboxState [i] ) { 

check. setSelected( true) ; 

} else { 

check . setSelected (false) ; 

} 



checkboxList . get (i) ; 

Now the state of ea eh of the 



sequencer . stop () ; 
buildTrackAndStart () ; 

} // close method 
} // close inner class 



Now stop whatever is turrentlv P la Y m 3' 
and rebuild the se^ende «** the new 
state o-f the dhetkbov.es in the /WayLis-t 



jyjvti ^uuvni 



This version has a huge limitation! When you hit the "serialized" button, it 
serializes automatically, to a file named "Checkbox.ser" (which gets created if it 
doesn't exist). But each time you save, you overwrite the previously-saved file. 



Improve the save and restore feature, by incorporating a JFileChooser so that 
you can name and save as many different patterns as you like, and load/restore 
from any of your previously-saved pattern files. 
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serialization and file I/O 




Can they be saved? 

Which of these do you think are, or should be, 
serializable? If not, why not? Not meaningful? 
Security risk? Only works for the current 
execution of the JVM? Make your best guess, 
without looking it up in the API. 



Object type 

Object 

String 

File 

Date 

OutputStream 

JFrame 

Integer 

System 



Serializable? 

Yes / No 
Yes / No 
Yes / No 
Yes / No 
Yes / No 
Yes / No 
Yes / No 
Yes / No 



If not, why not? 



What's legalP 

Circle the code fragments 
that would compile (assuming 
they’re within a legal class). 



KEEP 



RIGHT 



FileReader fileReader = new FileReader () ; 

Buf feredReader reader = new Buf feredReader (fileReader) ; 



FileOutputStream f = new FileOutputStream(new File ("Foo . ser") ) ; 
ObjectOutputStream os = new ObjectOutputStream(f ) ; 



Buf feredReader reader = new Buf feredReader (new FileReader (file) ) ; 
String line = null; 

while ((line = reader . readLine () ) != null) { 
makeCard(line) ; 

} 



ObjectlnputStream is = new ObjectInputStream(new FileOutputStream ("Game. ser") ) ; 
GameCharacter oneAgain = (GameCharacter) is.readObject() ; 
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exercise: True or False 




This chapter explored the wonerful world of 
Java I/O. Your job is to decide whether each 
of the following l/O-related statements is 
true or false. 



on Fause 




1. Serialization is appropriate when saving data for non-Java programs to use. 

2. Object state can be saved only by using serialization. 

3. ObjectOutputStream is a class used to save serialized objects. 

4. Chain streams can be used on their own or with connection streams. 

5. A single call to writeObject() can cause many objects to be saved. 

6. All classes are serializable by default. 

7. The transient modiber allows you to make instance variables serializable. 

8. If a superclass is not serializable then the subclass can’t be serializable. 

9. When objects are deserialized, they are read back in last-in, brst out sequence. 

10. When an object is deserialized, its constructor does not run. 

11. Both serialization and saving to a text ble can throw exceptions. 

12. BufferedWriters can be chained to FileWriters. 

13. File objects represent hies, but not directories. 

14. You can’t force a buffer to send its data before it’s full. 

15. Both ble readers and ble writers can be buffered. 

16. The String split () method includes separators as tokens in the result array. 

17. Any change to a class breaks previously serialized objects of that class. 
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serialization and file I/O 





Code Magnets 

This one's tricky, ro we pron 



I File Edit Window Help Torture 



java DungeonTest 



promoted it from an Exercise to full Puzzle status. 
Reconstruct the code snippets to make a working Java program that 
produces the output listed below? (You might not need all of the magnets, 
and you may reuse a magnet more than once.) 



class DungeonGame 



UiieOutputStream 



implements Serializable^ 

try { 

y 

short getZ() { 
return z; 



fos = new 



atputStream( ''dg.ser ") } 



e .printStackTrace ( ) ; 






oos .close ( ) ; j 




~ 

Ob jectlnputStream ois = new 








int getX() { 
return x; 


Ob ject!nputStream(fis ) ; 





System. out . println ( d . getX ( ) +d . getY ( ) +d . getZ ( ) ) ; 



FilelnputStream fis = new 


public int x = 3; 


FileInputStream( "dg.ser ) 


'transient long y = 4; 





long getY ( ) { 
return y; 




catch (Exception e){j 



d = (DungeonGame) ois . readOb ject ( ) ; 



] 



Ob jectOutputStream oos = new 
ObjectOutputStream( fos ) ; 



oos 



.writeOb ject (d) ; 



DungeonGame d = n ew DungeonGame ( )^_ 
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exercise solutions 



//-v 

r^ercise Solutions 



1. Serialization is appropriate when saving data for non-Java programs to use. False 

2. Object state can be saved only by using serialization. False 

3. ObjectOutputStream is a class used to save serialized objects. True 

4. Chain streams can be usedon their own or with connection streams. False 

5. A single call to writeObject() can cause many objects to be saved. True 

6. All classes are serializable by default. False 

7. The transient modiber allows you to make instance variables serializable. False 

8. If a superclass is not serializable then the subclass can’t be serializable. False 

9. When objects are deserialized they are read back in last-in, brst out sequence. False 

10. When an object is deserialized, its constructor does not run. True 

11. Both serialization and saving to a text ble can throw exceptions. True 

12. BufferedWriters can be chained to FileWriters. True 

13. File objects represent hies, but not directories. False 

14. You can’t force a buffer to send its data before it’s full. False 

15. Both ble readers and ble writers can optionally be buffered. True 

16. The String split () method includes separators as tokens in the result array. False 

17. Any change to a class breaks previously serialized objects of that class. False 
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serialization and file I/O 




import j ava . io . * ; 



class DungeonGame implements Serializable { 
public int x = 3; 
transient long y = 4; 
private short z = 5; 
int getX() { 
return x; 

} 

long getY ( ) { 
return y; 

} 

short getZ ( ) { 
return z; 

} 

} 



File Edit Window Help Escape 



% java DungeonTest 

12 

8 



class DungeonTest { 

public static void main (String [] args ) { 

DungeonGame d = new DungeonGame ( ) ; 

System. out. println ( d. getX ( ) + d.getY() + d.getZ()); 
try { 

FileOutputStream fos = new FileOutputStream( "dg. ser" ) ; 
Ob jectOutputStream oos = new Ob jectOutputStream( fos ) ; 
oos .writeOb ject ( d ) ; 
oos .close( ) ; 

FilelnputStream fis = new FileInputStream( "dg. ser" ) ; 
ObjectlnputStream ois = new Ob jectInputStream(fis ) ; 
d = (DungeonGame) ois . readOb ject () ; 
ois .close( ) ; 

} catch (Exception e) { 
e .printStackTrace ( ) ; 

} 

System. out. println ( d. getX ( ) + d.getY() + d.getZ()); 



} 



} 
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1 5 networking and threads 



Make a Connection 




Connect with the outside world. Your Java program can reach out and touch a 
program on another machine. It's easy. All the low-level networking details are taken care of by 
classes in the java.net library. One of Java's big benefits is that sending and receiving data over 
a network is just I/O with a slightly different connection stream at the end of the chain. If you've 
got a Buffered Reader, you can read. And the BufferedReader could care less if the data came 
out of a file or flew down an ethernet cable. In this chapter we'll connect to the outside world 
with sockets. We'll make client sockets. We'll make server sockets. We'll make clients and servers. 
And we'll make them talk to each other. Before the chapter's done, you'll have a fully-functional, 
multithreaded chat client. Did we just say multithreaded ? Yes, now you will learn the secret of 
how to talk to Bob while simultaneously listening to Suzy. 
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beat box chat 



Real-time Peat Pox Chat 



IRur 

Bass Drum 



D ^s Drum & 7 p-, — S^Beateox 

F^ss^s^sss 

rpmmmm 

- mSsilll^SESS ^ 

°oa^Snng 9 ®°®Soo - 

srr ilsSgglflsS 



Hand 
High Tom 
Hi Bongo 
Maracas 
Whistle 
Low Conga 
Cowbell 
Wbras/ap 



°P«>Hf CongaQQQ^ G O □ Q Q q q Q OQQ n 'Ok 

~~~^aooooossao nfoWish 



sequence 12 

o^^. s Mer2 lbut 



more 



skyler5:yo u WISH! Too 



ftNP 1°^ 

patter* 



perky 



You’re working on a computer game. You and your team 
are doing the sound design for each part of the game. 
Using a ‘chat’ version of the Beat Box, your team can 
collaborate — you can send a beat pattern along with 
your chat message, and everybody in the Beat Box Chat 
gets it. So you don’t just get to rmd the other 
participants’ messages, you get to load and 
play a beat pattern simply by clicking the 
message in the incoming messages area. 

In this chapter we’re going to learn what it 
takes to make a chat client like this. We’re 
even going to learn a little about making a 
chat server. We’ll save the full Beat Box Chat 
for the Code Kitchen, but in this chapter you 
will write a Ludicrously Simple Chat Client and 
Very Simple Chat Server that send and receive 
text messages. 



ditkM a ™ teWe L ? T essa5 + 

loads 

With 



/ou £a« have do^ple^J 
a;th e ^,d, m-telled-twaHy 7 
stimula-Ug dtal 1 
Warsaiiohs. Every 
message is seirfc to all 

partidipah-fcs. 




Send your message to the server 
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networking and threads 



Chat Program Overview 

The Client has to Lnow 
about the Server. 

The Server has to hnow 
about ALL the Clients. 



How it Works: 

Q Client connects to the server 



o The server makes a 

connection and adds the client 
to the list of participants 

^ Another client connects 



Q Client A sends a message to 
the chat service 




OL Scv-vcv"; f d like to donnedt - 
\ to the dhat sev-vide 



Client A 



Waiting for 
client requests 



Server 




0 


'Who -took -the lava lamp 


f 


Message 




my dovm voorn? 




received 1 



Client A Server 



^ The server distributes the 
message to ALL participants 
(including the original sender) 



w Who took the lava I a^_ 







Client A ^ 

Client B 



Message 
distributed to 
all participants 

1 m — 

Server 
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socket connections 



Connecting, Sending, and Receiving 

The three things we have to learn to get the client working are : 

1 ) How to establish the initial connection between the client and server 

2 ) How to send messages to the server 

3 ) How to receive messages from the server 

There’s a lot of low-level stuff that has to happen for these things to work. But we’re 
lucky, because the Java API networking package (java.net) makes it a piece of cake 
for programmers. You’ll see a lot more GUI code than networking and I/O code. 

And that’s not all. 

Lurking within the simple chat client is a problem we haven’t faced so far in this 
book: doing two things at the same time. Establishing a connection is a one-time 
operation (that either works or fails) . But after that, a chat participant wants to 
send outgoing messages and simultaneously receive incoming messages from the other 
participants (via the server). Hmmmm... that one’s going to take a little thought, but 
we’ll get there in just a few pages. 



O Connect 

Client connects to the server by 
establishing a Socket connection. 

Make a sodke-t dormedtio* -to 
|^.IM-.|.|03 at port $000 

Client A 




chat server at 
196.164.1.103, 
port 5000 



Server 



& Send 

Client sends a message to the server 

Eh writer pv’in'tIv/sMesMJt) 

Client A 

Q Receive 

Client gets a message from the server 



Server 
machine at 
196.164.1.103 



Server 



a 



Client A 



Stv-'mj s =• v-cadcv- rcadLincO 



Server 
machine at 
196.164.1.103 

Server 
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networking and threads 



Make a network Socket connection 



To connect to another machine, we need a Socket connection. 
A Socket ( java.net.Socket class) is an object that represents 
a network connection between two machines. What’s a 
connection? A relationship between two machines, where two 
pieces of software know about each other. Most importantly, 
those two pieces of software know how to communicate with 
each other. In other words, how to send bits to each other. 

We don’t care about the low-level details, thankfully, because 
they’re handled at a much lower place in the ‘networking 
stack’. If you don’t know what the ‘networking stack’ is, don’t 
worry about it. It’s just a way of looking at the layers that 
information (bits) must travel through to get from a Java 
program running in a JVM on some OS, to physical hardware 
(ethernet cables, for example), and back again on some other 
machine. Somebody has to take care of all the dirty details. 

But not you. That somebody is a combination of OS-specific 
software and the Java networking API. The part that you have 
to worry about is high-level — make that very high-level — and 
shockingly simple. Ready? 



To make a Socket 
connection, you need 
to know two tilings 
about ike server : who 
it is, and which port 
it’s running on. 

In other words, 

IP address and TCP 
port number. 



TCP 

X 






Socket chatSocket = new Socket ("196 . 164 . 1 . 103" , 5000) 




IpCivessW-tV* server 



We itSo** 






sotv.a 

/V7-V2- 





Client 



Server 



A Socket connection means the two machines have 
information about each other, including network 
location (IP address) and TCP port. 
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well-known ports 



A TCP port is just a number: 

A 1 6-bit number that Identifies 
a specific program on the server 



Your internet web (HTTP) server runs on port 80. That’s a 
standard. If you’ve got a Telnet server, its running on port 
23. FTP? 20. POP3 mail server? 110. SMTP? 25. The Time 
server sits at 37. Think of port numbers as unique identifiers. 
They represent a logical connection to a particular piece of 
software running on the server. That’s it. You can’t spin your 
hardware box around and find a TCP port. For one thing, 
you have 65536 of them on a server (0 - 65535) . So they 
obviously don’t represent a place to plug in physical devices. 
They’re just a number representing an application. 

Without port numbers, the server would have no way of 
knowing which application a client wanted to connect to. 
And since each application might have its own unique 
protocol, think of the trouble you’d have without these 
identifiers. What if your web browser, for example, landed 
at the POP3 mail server instead of the HTTP server? The 
mail server won’t know how to parse an HTTP request! And 
even if it did, the POP3 server doesn’t know anything about 
servicing the HTTP request. 

When you write a server program, you’ll include code that 
tells the program which port number you want it to run on 
(you’ll see how to do this in Java a little later in this chapter) . 
In the Chat program we’re writing in this chapter, we picked 
5000. Just because we wanted to. And because it met the 
criteria that it be a number between 1024 and 65535. Why 
1024? Because 0 through 1023 are reserved for the well- 
known services like the ones we just talked about. 

And if you’re writing services (server programs) to run on 
a company network, you should check with the sys-admins 
to find out which ports are already taken. Your sys-admins 
might tell you, for example, that you can’t use any port 
number below, say, 3000. In any case, if you value your limbs, 
you won’t assign port numbers with abandon. Unless it’s 
your home network. In which case you just have to check with 
your kids. 



Well-known TCP port numbers 
for common server applications 




f+TTPS P0P3 HTr P 



h scv-vcv* ca* have up -to 65536 
di-f-fev-eni server apps running, 
one per port. 



The TCP port 
numbers from o to 1023 
are reserved for well- 
known services. Don’t 
use them for your own 
server programs!* 

The chat server we’re 
writing uses port 
5000. We just picked a 
number between 1024 
and 65535. 



*Well, you might be able to use one of 
these, but the sys-admin where you 
work will probably kill you. 
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networking and threads 




V: How do you know the port 
number of the server program you 
want to talk to? 

A* 

Jr \‘ That depends on whether the 
program is one of the well-known 
services. If you're trying to connect 
to a well-known service, like the ones 
on the opposite page (HTTP, SMTP, 
FTP, etc.) you can look these up on 
the internet (Google "Well-Known 
TCP Port"). Or ask your friendly 
neighborhood sys-admin. 

But if the program isn't one of the 
well-known services, you need to 
find out from whoever is deploying 
the service. Ask him. Or her.Typically, 
if someone writes a network service 
and wants others to write clients for 
it, they'll publish the IP address, port 
number, and protocol for the service. 
For example, if you want to write a 
client for a GO game server, you can 
visit one of the GO server sites and 
find information about how to write a 
client for that particular server. 



x, : Can there ever be more than 
one program running on a single 
port? In other words, can two 
applications on the same server have 
the same port number? 

A* 

Jr \ m No! If you try to bind a program 
to a port that is already in use, you'll 
get a BindException.To bind a program 
to a port just means starting up a 
server application and telling it to run 
on a particular port. Again, you'll learn 
more about this when we get to the 
server part of this chapter. 



IP address is -the mall 



FW; Ku^beir is ihe sped j£ c 

i„ th e ma n rec ' t,£ 




I I 

ill 



IP address is like specifying a 
particular shopping mall, say, 
‘Flatirons Marketplace" 



Port number is like naming 
a specific store, say, 
"Bob's CD Shop" 




Brain Barbell 



OK, you got a Socket connection. The client and the 
server know the IP address and TCP port number for 
each other. Now what? How do you communicate 
over that connection? In other words, how do you 
move bits from one to the other? Imagine the kinds of 
messages your chat client needs to send and receive. 



How do -these b^° i J 

aeWN “tatt* to 



eath o- 



N taiK- 
rthev*? 




Client 



Server 
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reading from a socket 



To read data from a Socket use a 
BufferedReader 

To communicate over a Socket connection, you use streams. 
Regular old I/O streams, just like we used in the last chapter. One 
of the coolest features in Java is that most of your 1 / O work won’t 
care what your high-level chain stream is actually connected to. In 
other words, you can use a BufferedReader just like you did when 
you were writing to a file, the difference is that the underlying 
connection stream is connected to a Socket rather than a File ! 



Make a S ocket connection to the server 




iny u-t and output streams 
to and -from the Sodket 
donnediions v 



Tke ?<^ * 




Socket chatSocket = new Socket ("127 . 0 . 0 . 1 " , 5000); 



Make an InputStreamReader chained 
low-level (connection) input stream 



to the Socket's 



InputStreamReader 

| e vel W/ patter sW 

the tWm st'rearr,). 



stream = new InputStreamReader (chatSocket . getlnputStreamf) ) ; 

/ 



All we have -to do is As^ .1 < ^ 
ft. input sbtea J /+'/ 1 , *? dtet ^ 

sbJL, but W eVets+ ° W ' eV L £< T^ io * 



O Make a BufferedReader and read! 



> e ^«evedR e ade.y^ 



BufferedReader reader = new BufferedReader (stream) ; 
String message = reader . readLine () ; 




buffered characters converted to characters bytes from server 




BufferedReader InputStreamReader Socket's input stream 

(we don't need to know 
the actual class) 
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networking and threads 



To write data to a Socket ose a 
PrintWriter 



We didn’t use PrintWriter in the last chapter, we used BufferedWriter. We have 
a choice here, but when you’re writing one String at a time, PrintWriter is the 
standard choice. And you’ll recognize the two key methods in PrintWriter, 
print () and println() ! Just like good ol’ System. out. 



i -the 



Make a Socket connection to the server 

Socket chatSocket = new Socket ("127 .0.0.1' 



0?V os,-te W ' J to towett Vt 

f SCVV/CV-, wc still 



4 

5000) 



Make a PrintWriter chained to the Socket's low-level 
(connection) output stream 



PrintWriter writer = new PrintWriter (chatSocket . getOutputStream() ) ; 



f 







o Write (print) something 



writer .println ("message to send"); 
writer .print ("another message") ; 



, , M . ,-a O? it se»>ds- 

addsa^Watt 

doesn’t add the *> e ' M ' me ' 



souv-de 

si characters bytes to server 



pi 








011010011 


f 


message... ' 


f 

chained to 






PrintWriter 




Socket's outpir 



Client Stream (we don't need 

to know the actual class) 



aestmat'o" 

i 




Server 
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writing a client 



The PailyAdviceClient 

Before we start building the Chat app, 
let’s start with something a little smaller. 
The Advice Guy is a server program that 
offers up practical, inspirational tips 
to get you through those long days of 
coding. 

We’re building a client for The Advice 
Guy program, which pulls a message 
from the server each time it connects. 

What are you waiting for? Who knows 
what opportunities you’ve missed 
without this app. 




The Advice Guy 

O Connect 

Client connects to the server and gets an 
input stream from it 





Make a sodke-t doymedtion -to 


A 


’q! 


advice server 


\°lO.\te.\.lOl ai fort 4 - 2 A 2 . 


at 190.165.1.103, l 




4 sodkef.fteH^Pu'tSFvcaw'O 


port 4242 \ 


Client 




Server 



^ Read 

Client reads a message from the server 




ad vide — v-eadev-readLmeO 




Server 
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networking and threads 



PailyAdviceClient code 

This program makes a Socket, makes a BufferedReader (with the 
help of other streams), and reads a single line from the server 
application (whatever is running at port 4242). 



import j ava . io . * ; 
import j ava . net . * ; 



. t\ass Sotket m y 



\ava-nfft 



public class DailyAdviceClient { 



public void go() { 
try { ^ .. a lot 






heve 






Socket s = new Socket ("127 . 0 . 0 . 1" , 4242); 



InputStreamReader streamReader = new InputStreamReader (s .getInputStream() ) ; 
BufferedReader reader = new BufferedReader (streamReader) ; a Bv-f-fcvcdRcadcv to 



String advice = reader . readLine () ; 
System. out .pr in tin ("Today you should: 



reader . close ( ) ; 4 ‘-this closes fiLL the streams 



catch ( IOException ex) { 
ex . prints tackTrace ( ) ; 



an InyutStvea^Readev to 
the input stvea** -(■vo*n the 
Socket- 



+ advice) ; 






public static void main (String [] args) { 

DailyAdviceClient client = new DailyAdviceClient () ; 
client . go ( ) ; 

} 

} 
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networking and threads 



Writing a simple server 

So what’s it take to write a server application? Just a 
couple of Sockets. Yes, a couple as in two. A ServerSocket, 
which waits for client requests (when a client makes a 
new Socket ()) and a plain old Socket socket to use for 
communication with the client. 



How it Works: 



Q Server application makes a ServerSocket, on a specific port 



ServerSocket serverSock = new ServerSocket (4242); 



This starts the server application listening 
for client requests coming in for port 4242. 








© 



Client makes a Socket connection to the server application 

Socket sock = new Socket ("190 . 165 . 1 . 103" , 4242); 



Client knows the IP address and port number 
(published or given to him by whomever 
configures the server app to be on that port) 





© 



Server makes a new Socket to communicate with this client 



Socket sock = serverSock . accept ( ) ; 

The accept() method blocks (just sits there) while 
it's waiting for a client Socket connection. When a 
client finally tries to connect, the method returns 
a plain old Socket (on a different port) that knows 
how to communicate with the client (i.e., knows the 
client's IP address and port number). The Socket is on 
a different port than the ServerSocket, so that the 
ServerSocket can go back to waiting for other clients. 




got ket 



W ^ 
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writing a server 



PailyAdviceServer code 

This program makes a ServerSocket and waits for client requests. When it gets 
a client request (i.e. client said new Socket() for this application), the server 
makes a new Socket connection to that client. The server makes a PrintWriter 
(using the Socket’s output stream) and sends a message to the client. 



import j ava . io . * ; 
import j ava . net . * ; 






h* to* 






public class DailyAdviceServer { 






String [] adviceList = {"Take smaller bites", "Go for the tight jeans. No they do NOT 
make you look fat.", "One word: inappropriate", "Just for today, be honest. Tell your 
boss what you *really* think", "You might want to rethink that haircut."}; 



public void go ( ) { 






L, seY . vev - ooes into a w»a»>o>t 1°°?. 

aitmj tor se ' rVltm ^ ) 6 ' rere ' 
while (true) { 

Socket sock = serverSock . accept (); 



on 

Code is 






try { 

ServerSocket serverSock = new ServerSocket (4242) ; 

* the addeyt method blodks (just sits thev-e) uhtil a 

request domes ih, ahd then the method v*etuv*hs a 
Sodket (oh some ahohymous port) for dommuhidatrn^ 
with the dlieht 



PrintWriter writer = new PrintWriter (sock .getOutputStream() ) ; 
String advice = getAdvice() ; 
writer . println (advice) ; 
writer . close ( ) ; 

System. out .println (advice) ; 



rt 1 “ z 

we re dome with -this d, en l * S Cke * be£ause 



} catch ( IOException ex) { 
ex . prints tackTrace ( ) ; 

} 

} // close go 



private String getAdvice() { 

int random = (int) (Math . random ( ) * adviceList . length) ; 
return adviceList [random] ; 

} 



public static void main (String [] args) { 

DailyAdviceServer server = new DailyAdviceServer () ; 
server . go ( ) ; 

} 

} 
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networking and threads 




=0 

Brain Barbell 



How does the server know how to 
communicate with the client? 

The client knows the IP address and port 
number of the server, but how is the server 
able to make a Socket connection with the 
client (and make input and output streams)? 

Think about how / when / where the server 
gets knowledge about the client. 




V; The advice server code on the opposite 
page has a VERY serious limitation — it looks 
like it can handle only one client at a time! 

A. 

Jr \ m Yes, that's right. It can't accept a request 
from a client until it has finished with the 
current client and started the next iteration of 
the infinite loop (where it sits at the acceptO 
call until a request comes in, at which time it 
makes a Socket with the new client and starts 
the process over again). 



0? Let me rephrase the problem: how can 
you make a server that can handle multiple 
clients concurrently??? This would never 
work for a chat server, for instance. 



A- 

Ah, that's simple, really. Use separate 
threads, and give each new client Socket to a 
new thread. We're just about to learn how to 
do that! 



BULLET POINTS 

■ Client and server applications communicate over a Socket 
connection. 

■ A Socket represents a connection between two applications 
which may (or may not) be running on two different physical 
machines. 

■ A client must know the IP address (or domain name) and 
TCP port number of the server application. 

■ A TCP port is a 16-bit unsigned number assigned to a 
specific server application. TCP port numbers allow different 
clients to connect to the same machine but communicate 
with different applications running on that machine. 

■ The port numbers from 0 through 1 023 are reserved for 
‘well-known services’ including HTTP, FTP, SMTP, etc. 

■ A client connects to a server by making a Server socket 
Socket s = new Socket ("127 . 0 . 0 . 1 " , 4200); 

■ Once connected, a client can get input and output streams 
from the socket. These are low-level ‘connection’ streams. 

sock . getlnputStream ( ) ; 

■ To read text data from the server, create a BufferedReader, 
chained to an I nputStream Reader, which is chained to the 
input stream from the Socket. 

■ InputStreamReader is a ‘bridge’ stream that takes in 
bytes and converts them to text (character) data. It’s used 
primarily to act as the middle chain between the high-level 
BufferedReader and the low-level Socket input stream. 

■ To write text data to the server, create a PrintWriter chained 
directly to the Socket’s output stream. Call the print() or 
println() methods to send Strings to the server. 

■ Servers use a ServerSocket that waits for client requests on 
a particular port number. 

■ When a ServerSocket gets a request, it ‘accepts’ the request 
by making a Socket connection with the client. 



you are here ► 485 



h 

a 

S 

s< 

ii 

h 

M 

s 

s 

Ci 

G 

h 

s 

E 

A 

2 

Ii 

h 



s; 



Head First Java, 2nd Edition. Head First Java, 2nd Edition, ISBN: 0596009208 

Prepared for e.simons@icarin.fiuc.org, Eduard Simons 

Copyright © 2005 Bert Bates and Kathy Sierra. This PDF is made available for personal use only during the relevant subscription term, subject to the Safari Terms of Service. Any other use 
requires prior written consent from the copyright owner. Unauthorized use, reproduction and/or distribution are strictly prohibited and violate applicable laws. All rights reserved. 



a simple chat client 



Writing a Chat Client 

We’ll write the Chat client application in two stages. First we’ll 
make a send-only version that sends messages to the server but 
doesn’t get to read any of the messages from other participants 
(an exciting and mysterious twist to the whole chat room 
concept) . 

Then we’ll go for the full chat monty and make one that both 
sends and receives chat messages. 

Version One: send-only 




ln>es sa 

..4- mess ays Y 



Code outline 

public class SimpleChatClientA { 

JTextField outgoing; 

PrintWriter writer; 

Socket sock; 

public void go() { 

// make gui and register a listener with the send button 
// call the setUpNetworking () method 

} 

private void setUpNetworking () { 

// make a Socket, then make a PrintWriter 

// assign the PrintWriter to writer instance variable 

} 

public class SendButtonListener implements ActionListener { 
public void actionPerf ormed (ActionEvent ev) { 

// get the text from the text field and 

// send it to the server using the writer (a PrintWriter) 

} 

} // close SendButtonListener inner class 

} // close outer class 
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networking and threads 



import j ava . io . * ; 
import j ava . net . * ; 
import j avax . swing . * ; 
import j ava . awt . * ; 
import j ava . awt . event . * ; 



I £ y, e sbrea"^ 



public class SimpleChatClientA { 

JTextField outgoing; 
PrintWriter writer; 

Socket sock; 



public void go() { 

JFrame frame = new JFrame ("Ludicrously Simple Chat Client 
JPanel mainPanel = new JPanel ( ) ; 
outgoing = new JTextField (20) ; 

JButton sendButton = new JButton ("Send") ; 

sendButton . addActionListener (new SendButtonListener ( ) ) ; 

mainPanel . add (outgoing) ; 

mainPanel . add (sendButton) ; 

frame . getContentPane ( ) . add (BorderLayout . CENTER , mainPanel) 
setUpNetworking () ; 
frame . setSize (400 , 500) ; 
frame . setVisible (true) ; 

} // close go weVe using lodalW so 

you can i e si i he deni 



\\crc, ar-d 

^•twovkmg or \fV- 



on oxe machine 



private void setUpNetworking () { and setven 
try { 

sock = new Socket ("127 . 0 . 0 . 1 " , 5000); 

writer = new PrintWriter (sock .getOutputStream() ) 

System. out .println ("networking established") ; 

} catch (IOException ex) { 
ex . printStackTrace ( ) ; 

} 

} // close setUpNetworking 



This is where we make the Sodket 
and the PrintWriter (its tailed 

tom the goO method right betre 

displaying the app 



public class SendButtonListener implements ActionListener { 



public void actionPerf ormed (ActionEvent ev) { 
try { 

writer . println ( outgoing . getText ( ) ) 
writer . flush ( ) ; 



} catch (Exception ex) { 
ex. printStackTrace () ; 



(Vow we actually do the wv-itmj. 
Rerwerwbev-, the writer is dha'med to 
the input stream -from the Sodket, so 
whenever we do a printlnO, it goes 
over the network to the server/ 



} 

outgoing . setText ( " " ) ; 
outgoing . requestFocus ( ) ; 

} 

} // close SendButtonListener inner class 

public static void main (String [] args) { 
new SimpleChatClientA () .go() ; 

} 

} // close outer class 



If you want to try this now, type in 
the Ready-bake chat server code 
listed at the end of this chapter . 
First, start the server in one terminal. 
Next, use another terminal to start 
this client. 
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improving the chat client 



Version Two: 
and receive 







message display area until the 



The Server sends a message to all 
client participants, as soon as the 
message is received by the server. 
When^a client sends a message, it 
doesn't appear in the incoming 



messages 



scv-vcv- 



schds it to 



everyone. 



ou 




Big Question: HOW do you get messages from the server? 

Should be easy; when you set up the networking make an input stream as well 
(probably a BufferedReader) . Then read messages using readLine(). 

Bigger Question: WHEN do you get messages from the server? 

Think about that. What are the options? 

(T) Option One: Poll the server every 20 seconds 

Pros: Well, it’s do-able 

Cons: How does the server know what you’ve seen and what you haven’t? The server 
would have to store the messages, rather than just doing a distribute-and-forget each time 
it gets one. And why 20 seconds? A delay like this affects usability, but as you reduce the 
delay, you risk hitting your server needlessly. Inefficient. 

(2) Option Two: Read something in from the server each time the user 
sends a message. 

Pros: Do-able, very easy 

Cons: Stupid. Why choose such an arbitrary time to check for messages? What if a user is 
a lurker and doesn’t send anything? 

@ Option Three: Read messages as soon as they’re sent from the server 

Pros: Most efficient, best usability 

Cons: How do you do you do two things at the same time? Where would you put this code? 
You’d need a loop somewhere that was always waiting to read from the server. But where 
would that go? Once you launch the GUI, nothing happens until an event is bred by a GUI 
component. 
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networking and threads 




You know by now that we’re 
going with option three. 

We want something to run continuously, 
checking for messages from the server, 
but without interrupting the user’s ability to 
interact with the GUI! So while the user is 
happily typing new messages or scrolling 
through the incoming messages, we 
want something behind the scenes to keep 
reading in new input from the server. 

That means we finally need a new thread. 
A new, separate stack 

We want everything we did in the Send- 
Only version (version one) to work the 
same way, while a new process runs along 
side that reads information from the 
server and displays it in the incoming text 
area. 

Well, not quite. Unless you have multiple 
processors on your computer, each new 
Java thread is not actually a separate 
process running on the OS. But it almost 
feels as though it is. 



In Java you really CAN 
walk and cliew gum at 
the same time. 



Multithreading in Java 

Java has multiple threading built right 
into the fabric of the language. And it’s a 
snap to make a new thread of execution: 

Thread t = new Thread () ; 
t . start () ; 

That’s it. By creating a new Thread object, 
you’ve launched a separate thread of 
execution, with its very own call stack. 

Except for one problem. 

That thread doesn’t actually do anything, 
so the thread “dies” virtually the instant 
it’s born. When a thread dies, its new 
stack disappears again. End of story. 

So we’re missing one key component — 
the thread’s In other words, we need 
the code that you want to have run by a 
separate thread. 

Multiple threading in Java means we 
have to look at both the thread and the job 
that’s run by the thread. And we’ll also 
have to look at the Thread class in the 
java.lang package. (Remember, java.lang 
is the package you get imported for 
free, implicitly, and it’s where the classes 
most fundamental to the language live, 
including String and System.) 
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threads and Thread 



Java has multiple threads but only 
om Thread class 



We can talk about thread with a lower-case ‘t’ and Thread 
with a capital ‘T\ When you see thread, we’re talking 
about a separate thread of execution. In other words, 
a separate call stack. When you see Thread, think of 
the Java naming convention. What, in Java, starts with a 
capital letter? Classes and interfaces. In this case, Thread 
is a class in the java. lang package. A Thread object 
represents a thread of execution) you’ll create an instance of 
class Thread each time you want to start up a new thread 
of execution. 



A thread is a separate 
‘thread of execution’. 
In other words, a 
separate call stack. 

A Thread is a Java 
class that represents 
a thread. 

To make a thread, 
make a Thread. 



Mi read 



Thread 



\ y.bar() ] 




main( ) 

main thread 



/ doMore( V 

y - 

j doStuff( 

( run( ) 



another thread 
started by the code 



Thread 

void join() 
void start() 

static void sleepQ 



java. lang. Thread 

class 



A thread (lower-case ‘t’) is a separate thread of execution. 
That means a separate call stack. Every Java application 
starts up a main thread — the thread that puts the 
main() method on the bottom of the stack. The JVM 
is responsible for starting the main thread (and other 
threads, as it chooses, including the garbage collection 
thread) . As a programmer, you can write code to start 
other threads of your own. 



Thread (capital ‘T’) is a class that 
represents a thread of execution. 

It has methods for starting a 
thread joining one thread with 
another, and putting a thread to 
sleep. (It has more methods; these 
are just the crucial ones we need 
to use now) . 
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networking and threads 

What docs it m aw to have more than 
om call stack? 



With more than one call stack, you get the appearance of having 
multiple things happen at the same time. In reality, only a true 
multiprocessor system can actually do more than one thing at a 
time, but with Java threads, it can appear that you’re doing several 
things simultaneously. In other words, execution can move back 
and forth between stacks so rapidly that you feel as though all stacks 
are executing at the same time. Remember, Java is just a process 
running on your underlying OS. So first, Java itself has to be ‘the 
currently executing process’ on the OS. But once Java gets its 
turn to execute, exactly what does the JVM run , ? Which bytecodes 
execute? Whatever is on the top of the currently-running stack! 
And in 100 milliseconds, the currently executing code might switch 
to a different method on a different stack. 



One of the things a thread must do is keep track of which statement 
(of which method) is currently executing on the thread’s stack. 

It might look something like this: 



The JVM calls the main() method. 

public static void main (String [ ] args) 

} 



the active thread 

i 




main thread 




mainO starts a new thread. The main 
thread is temporarily frozen while the new 
thread starts running. 



Runnable r = new MyThreadJob ( ) ; 
Thread t = new Thread (r) -• w— 'n • 
t . start () ; 

Dog d = new Dog() ; 



y® u II learn what 

this rncans i h ; us i 
2 foment... 



t.start() 

main thread 



a new thread starts 
and becomes the adtive 
thread \ 




user thread A 




The JVM switches between the new 
thread (user thread A) and the original 
main thread, until both threads complete. 







main thread 



x.g oQ J 
run() j 
user thread A 
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launching a thread 



How to launch a new thread: 



Q Make a Runnable object (the thread’s job) 

Runnable threadJob = new MyRunnable ( ) ; 

Runnable is an interface you'll learn about on the next page. 
You'll write a class that implements the Runnable interface, 
and that class is where you'll define the work that a thread 
will perform. In other words, the method that will be run 
from the thread's new call stack. 




Q Make a Thread object (the worker) and 
give it a Runnable (the job) 

Thread myThread = new Thread (threadJob) ; 

Pass the new Runnable object to the Thread constructor. 
This tells the new Thread object which method to put on 
the bottom of the new stack— the Runnable's run() method. 




0 Start the Thread 

myThread . start ( ) ; 

Nothing happens until you call the Thread's 
start() method. That's when you go from 
having just a Thread instance to having a new 
thread of execution. When the new thread 
starts up, it takes the Runnable object's 
run() method and puts it on the bottom of 
the new thread's stack. 



run() 
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Every Thread needs a job to do. 

A method to pot on the new thread stack 



networking and threads 




Runnable is to a 
Thread what a job is to 
a worker. A Runnable 
is the job a thread is 
supposed to run. 

A Runnable holds the 
method that goes on 
the bottom of the new 
thread’s stack run(). 



A Thread object needs a job. Ajob the thread will run when the 
thread is started. That job is actually the first method that goes on 
the new thread’s stack, and it must always be a method that looks 
like this: 

public void run ( ) { 

// code that will be run by the new thread 

} 



• te^ ate 0 < tev, 't’ s ar> 

TVv« u-J'xoiA VW0- veo>ard\e ss 
„ e tw>A, r w>t H 

\rvte’ r ^ ate i0 i. N oe 






How does the thread know which method to put at the bottom of 
the stack? Because Runnable defines a contract. Because Runnable 
is an interface. A thread’s job can be defined in any class that 
implements the Runnable interface. The thread cares only that you 
pass the Thread constructor an object of a class that implements 
Runnable. 

When you pass a Runnable to a Thread constructor, you’re really 
just giving the Thread a way to get to a run() method. You’re giving 
the Thread its job to do. 
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Runnable interface 



To wake a job for yoor thread, 
implement the Runnable interface 









so yo* 



public class MyRunnable 

public void run() { 

go() ; 

} 

public void go ( ) { 

doMore ( ) ; 

} 



implements Runnable 



v Runnable has only one method to 
implement publid Void vunO (with no 

tier?** n '\ s h y- p«t the 

rT tt>e IS supposed to vun. This 

* the method that goes at the bottom 
o\ the new stadk. 



public void doMore ( ) { 

System. out .println ("top o' the stack"); 

} 



class ThreadTester { 



public static void main (String [] args) { 



Runnable thread Job = new MyRunnable ( ) ; 
Thread myThread = new Thread (thread Job) ; 



Thv-ead tonstrutW T bo y. om the nex 

/ what method to put on th ^ 

/ s^atk- In other nords, the 



STe ne^ thread Will 



myThread . start (); 



System . out . println ( "back in main" ) ; 



’ «T i 1 m ‘i‘T “ til 'i'- 

•is just a Thread 1 that, 



myThread . start() j 
main() 

main thread 




new thread 




Brain Barbell 



What do you think the output will be if you run the 
ThreadTester class? (we’ll find out in a few pages) 
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networking and threads 



The three states of a new thread 



this is 'wVveve a 
to W 



tVwcad 



Thread t = new Thread (r) ; 

NEW 

start () ; 



y/aitmg to 

started w 



Thread t = new Thread (r) ; 

A Thread instance has been 
created but not started. 

In other words, there is a 
Thread object, but no thread 
of execution. 





t . start () ; 

When you start the thread, it 
moves into the runnable state. 
This means the thread is ready 
to run and just waiting for its 
Big Chance to be selected for 
execution. At this point, there is 
a new call stack for this thread. 



This is the state all threads lust 
after! To be The Chosen One. 
The Currently Running Thread. 
Only the JVM thread scheduler 
can make that decision. You 
can sometimes influence that 
decision, but you cannot force a 
thread to move from runnable 
to running. In the running 
state, a thread (and ONLY this 
thread) has an active call stack, 
and the method on the top of 
the stack is executing. 



But there’s more. Once the thread becomes 
runnable, it can move back and forth between 
runnable, running, and an additional state: 
temporarily not runnable (also known as ‘blocked’). 
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thread states 



Typical runnable/running loop 



Typically, a thread moves back and 
forth between runnable and running, 
as the JVM thread scheduler selects a 
thread to run and then kicks it back 
out so another thread gets a chance. 



RUNNABLE RUNNING 




A thread can be made 
temporarily not-runnable 
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The thread scheduler can move a 
running thread into a blocked state, 
for a variety of reasons. For example, 
the thread might be executing code 
to read from a Socket input stream, 
but there isn’t any data to read. The 
scheduler will move the thread out 
of the running state until something 
becomes available. Or the executing 
code might have told the thread to 
put itself to sleep (sleep ()). Or the 
thread might be waiting because it 
tried to call a method on an object, 
and that object was ‘locked’. In that 
case, the thread can’t continue until 
the object’s lock is freed by the thread 
that has it. 



All of those conditions (and more) 
cause a thread to become temporarily 
not-runnable. 



RUNNING 



sleeping, waiting -f or another thread -to -finish, 
waiting -for daxa to be available on the stream, 
waiting -for an objedt’s lodk... 
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networking and threads 



The Thread Scheduler 



The thread scheduler makes all the decisions about 
who moves from runnable to running, and about when 
(and under what circumstances) a thread leaves the 
running state. The scheduler decides who runs, and for 
how long, and where the threads go when the scheduler 
decides to kick them out of the currently-running state. 

You can’t control the scheduler. There is no API for 
calling methods on the scheduler. Most importantly, 
there are no guarantees about scheduling! (There are a 
few a/mos^-guarantees, but even those are a little fuzzy.) 

The bottom line is this: do not base your program’s 
correctness on the scheduler working in a particular way! 

The scheduler implementations are different for 
different JVM’s, and even running the same program 
on the same machine can give you different results. 

One of the worst mistakes new Java programmers 
make is to test their multi-threaded program on a 
single machine, and assume the thread scheduler will 
always work that way, regardless of where the program 
runs. 

So what does this mean for write-once-run-anywhere? 

It means that to write platform-independent Java code, 
your multi-threaded program must work no matter how 
the thread scheduler behaves. That means that you can’t 
be dependent on, for example, the scheduler making 
sure all the threads take nice, perfectly fair and equal 
turns at the running state. Although highly unlikely 
today, your program might end up running on a JVM 
with a scheduler that says, “OK thread five, you’re up, 
and as far as I’m concerned, you can stay here until 
you’re done, when your run() method completes.” 

The secret to almost everything is sleep. That’s 
right, sleep. Putting a thread to sleep, even for a few 
milliseconds, forces the currently-running thread to 
leave the running state, thus giving another thread a 
chance to run. The thread’s sleep () method does come 
with one guarantee: a sleeping thread will not become 
the currently-running thread before the the length of 
its sleep time has expired. For example, if you tell your 
thread to sleep for two seconds (2,000 milliseconds), 
that thread can never become the running thread again 
until sometime after the two seconds have passed. 



Number four, you've had 
enough time. Back to runnable. 
Number two, looks like you're up! 

Oh, now it looks like you're gonna have 
to sleep. Number five, come take his 
place. Number two, you're still 
sleeping... 




The thread 
scheduler makes all 
the decisions about 
who runs and who 
doesn’t. He usually 
makes the threads take 
turns, nicely. But 
there’s no guarantee 
about that- He might 
let one thread run 
to its heart’s content 
while the other 
threads ‘starve’. 
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thread scheduling 



An example of how unpredictable the 
scheduler can be... 



Running this code on one machine: 



Produced this output: 



public class MyRunnable implements Runnable { 

public void run() { 

go() ; 

> 

public void go() { 
doMore ( ) ; 

} 

public void doMore ( ) { 

System. out .print In ("top o' the stack"); 

} 



class ThreadTestDrive { 



public static void main (String [] args) { 

Runnable thread Job = new MyRunnable ( ) ; 
Thread myThread = new Thread ( thread Job) ; 

myThread. start () ; 




| File Edit Window Help PickM~ 



% java 


ThreadTestDrive 


back in 


main 


top 0 ' 


the stack 


% java 


ThreadTestDrive 


top 0 ' 


the stack 


back in 


main 


% java 


ThreadTestDrive 


top 0 ' 


the stack 


back in 


main 


% java 


ThreadTestDrive 


top 0 ' 


the stack 


back in 


main 


% java 


ThreadTestDrive 


top 0 ' 


the stack 


back in 


main 


% java 


ThreadTestDrive 


top 0 ' 


the stack 


back in 


main 


% java 


ThreadTestDrive 


back in 


main 


top 0 ' 


the stack 
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networking and threads 



How did we end up with different results? 



Sometimes it runs like this: 



main() starts the 
new thread 



The scheduler sends 
the main thread out 
of running and back 
to runnable, so that 
the new thread can 
run. 




main thread 



myThread . start( ] 

main thread 



The scheduler lets 
the new thread 
run to completion, 
printing out “top o’ 
the stack” 




new thread 



The new thread goes 
away, because its run() 
completed. The main 
thread once again 
becomes the running 
thread, and prints “back 
in main” 




main thread 



► 

time 



And sometimes it runs like this: 



main() starts the 
new thread 



The scheduler sends 
the main thread out 
of running and back 
to runnable, so that 
the new thread can 
run. 



The scheduler lets the 
new thread run for a 
little while, not long 
enough for the run() 
method to complete. 



The scheduler 
sends the new 
thread back to 
runnable. 



The scheduler 
selects the main 
thread to be the 
running thread 
again. Main prints 
out “back in main” 



| myThreacLsto^ 
main() 

main thread 




main thread new thread 




new thread main thread 



The new thread returns 
to the running state 
and prints out “top o’ 
the stack”. 




new thread 



► 

time 
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socket connections 




I've seen examples that don't use a separate 
Runnable implementation, but instead just make a 
subclass of Thread and override the Thread's run() 
method. That way, you call the Thread's no-arg 
constructor when you make the new thread; 

Thread t = newThreadO; // no Runnable 

A* 

Jr \ m Yes, that is another way of making your own 
thread, but think about it from an 00 perspective. 
What's the purpose of subclassing? Remember that 
we're talking about two different things here — the 
Thread and the thread's job. From an 00 view, those 
two are very separate activities, and belong in separate 
classes. The only time you want to subclass/extend 
the Thread class, is if you are making a new and more 
specific type of Thread. In other words, if you think of 
the Thread as the worker, don't extend the Thread class 
unless you need more specific worker behaviors. But if 
all you need is a new job to be run by a Thread/worker, 
then implement Runnable in a separate, 706-specific 
(not wor/cer-specific) class. 

This is a design issue and not a performance or 
language issue. It's perfectly legal to subclass Thread 
and override the run() method, but it's rarely a good 
idea. 



x, : Can you reuse a Thread object? Can you give it 
a new job to do and then restart it by calling start() 
again? 

A* 

Jr \‘ No. Once a thread's run() method has completed, 
the thread can never be restarted. In fact, at that 
point the thread moves into a state we haven't talked 
about — dead. In the dead state, the thread has 
finished its run() method and can never be restarted. 
The Thread object might still be on the heap, as a 
living object that you can call other methods on (if 
appropriate), but the Thread object has permanently 
lost its 'threadness'. In other words, there is no longer a 
separate call stack, and the Thread object is no longer 
a thread. It's just an object, at that point, like all other 
objects. 

But, there are design patterns for making a pool of 
threads that you can keep using to perform different 
jobs. But you don't do it by restartingO a dead thread. 
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■ A thread with a lower-case ‘t’ is a separate thread of 
execution in Java. 

■ Every thread in Java has its own call stack. 

■ A Thread with a capital T is the java.Iang.Thread 
class. A Thread object represents a thread of 
execution. 

■ A Thread needs a job to do. A Thread’s job is an 
instance of something that implements the Runnable 
interface. 

■ The Runnable interface has just a single method, run(). 
This is the method that goes on the bottom of the new 
call stack. In other words, it is the first method to run in 
the new thread. 

■ To launch a new thread, you need a Runnable to pass 
to the Thread’s constructor. 

■ A thread is in the NEW state when you have 
instantiated a Thread object but have not yet called 
start(). 

■ When you start a thread (by calling the Thread object’s 
start() method), a new stack is created, with the 
Runnable’s run() method on the bottom of the stack. 
The thread is now in the RUNNABLE state, waiting to 
be chosen to run. 

■ A thread is said to be RUNNING when the JVM’s 
thread scheduler has selected it to be the currently- 
running thread. On a single-processor machine, there 
can be only one currently-running thread. 

■ Sometimes a thread can be moved from the RUNNING 
state to a BLOCKED (temporarily non-runnable) state. 
A thread might be blocked because it’s waiting for data 
from a stream, or because it has gone to sleep, or 
because it is waiting for an object’s lock. 

■ Thread scheduling is not guaranteed to work in any 
particular way, so you cannot be certain that threads 
will take turns nicely. You can help influence turn-taking 
by putting your threads to sleep periodically. 
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networking and threads 



Potting a thread to sleep 




One of the best ways to help your threads take turns is 
to put them to sleep periodically. All you need to do 
is call the static sleep () method, passing it the sleep 
duration, in milliseconds. 

For example: 

Thread. sleep (2000) ; 

will knock a thread out of the running state, and 
keep it out of the runnable state for two seconds. 
The thread can ’t become the running thread 
1 again until after at least two seconds have passed. 

A bit unfortunately, the sleep method throws an 
InterruptedException, a checked exception, so all 
calls to sleep must be wrapped in a try/ catch (or 
declared). So a sleep call really looks like this: 

try { 

Thread. sleep (2000) ; 
catch ( InterruptedException ex) { 
ex . printStackTrace ( ) ; 



Your thread will probably never be interrupted from 
sleep; the exception is in the API to support a thread 
communication mechanism that almost nobody uses in 
the Real World. But, you still have to obey the handle 
or declare law, so you need to get used to wrapping your 
sleep () calls in a try/catch. 



Now you know that your thread won’t wake up before the 
specified duration, but is it possible that it will wake up 
some time after the ‘timer’ has expired? Yes and no. It 
doesn’t matter, really, because when the thread wakes 
up, it always goes back to the runnable state! The thread 
won’t automatically wake up at the designated time and 
become the currently-running thread. When a thread 
wakes up, the thread is once again at the mercy of 
the thread scheduler. Now, for applications that don’t 
require perfect timing, and that have only a few threads, 
it might appear as though the thread wakes up and 
resumes running right on schedule (say, after the 2000 
milliseconds). But don’t bet your program on it. 



Put your thread to sleep 
if you want to be sure 
that other threads get a 
chance to run. 

When the thread wakes 
up, it always goes back 
to the runnable state 
and waits for the thread 
scheduler to choose it 
to run again. 
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using Thread. sleepQ 



Using sleep to make our program 
more predictable. 

Remember our earlier example that kept giving us different 
results each time we ran it? Look back and study the code 
and the sample output. Sometimes main had to wait until the 
new thread finished (and printed “top o’ the stack”), while 
other times the new thread would be sent back to runnable 
before it was finished, allowing the main thread to come back 
in and print out “back in main”. How can we fix that? Stop 
for a moment and answer this question: “Where can you put 
a sleep () call, to make sure that “back in main” always prints 
before “top o’ the stack”? 

We’ll wait while you work out an answer (there’s more than 
one answer that would work) . 

Figure it out? 



public class MyRunnable implements Runnable { 

public void run() { 
go ( ) ; 

} 



This is what we want— 3 Consistent order 
ot print statements: 

| File Edit Window Help SnoozeButton 



% java ThreadTestDrive 
back in main 
top o' the stack 
% java ThreadTestDrive 
back in main 
top o' the stack 
% java ThreadTestDrive 
back in main 
top o' the stack 
% java ThreadTestDrive 
back in main 
top o' the stack 
% java ThreadTestDrive 
back in main 
top o' the stack 



public void go() { 



try { 

Thread. sleep (2000) ; 

} catch (InterruptedException ex) { 
ex . prints tackTrace ( ) ; 

} 



doMore ( ) ; 

} 



<r 



•\\ £orCe the new 

Sm tV'" 1 

3 Witt V>e 



public void doMore () { 

System. out .pr in tin ("top o' the stack"); 

} 



class ThreadTestDrive { 

public static void main (String [] args) { 
Runnable the Job = new MyRunnable ( ) ; 
Thread t = new Thread (the Job) ; 
t. start () ; 

System. out .println ("back in main") ; 

} 

} 
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networking and threads 



Making and starting two threads 

Threads have names. You can give your threads a name of 
your choosing, or you can accept their default names. But the 
cool thing about names is that you can use them to tell which 
thread is running. The following example starts two threads. 
Each thread has the same job: run in a loop, printing the 
currently-running thread’s name with each iteration. 



public class RunThreads implements Runnable { 

public static void main (String [] args) { Make or\t 
RunThreads runner = new RunThreads ( ) ; 

Thread alpha = new Thread (runner) ; <; — aa . / 

Thread beta = new Thread (runner) ; ^ ^ C ' 11 WI ™ sar * c (the 

alpha. setName ("Alpha thread") o — , » li n '' < JT c aboui ibe w *fcv/o -tb\reads 

beta. setName ("Beta thread") ; *0 *** ° hC Ku ™ ablc *'» a +ew pajes). 

alpha . start ( ) ; fane threads 

beta, start () ; ^ 

, tws w?> 



> 



{ 






public void run ( ) 

for (int i = 0; i < 25; i++) { 

String threadName = Thread . currentThread ( ) . getName ( ) , 
System. out .pr in tin (threadName + " is running"); 



} 



} 



I File Edit Window Help Centauri 



What will happen? 



Pa\rt -the ou'tpu't wbch 
the loop iiev-ates Z5 
fames. 



Will the threads take turns? Will you see the thread names 
alternating? How often will they switch? With each iteration? 
After five iterations? 

You already know the answer: we don ’t know! It’s up to the 
scheduler. And on your OS, with your particular JVM, on 
your CPU, you might get very different results. 

Running under OS X 10.2 (Jaguar), with five or fewer 
iterations, the Alpha thread runs to completion, then 
the Beta thread runs to completion. Very consistent. Not 
guaranteed, but very consistent. 

But when you up the loop to 25 or more iterations, things 
start to wobble. The Alpha thread might not get to complete 
all 25 iterations before the scheduler sends it back to 
runnable to let the Beta thread have a chance. 
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aren’t threads wonderful? 




Uw, yes. There IS a dark side. 

Threads caw lead to cowcurrewcy 'issues' 

Concurrency issues lead to race conditions. Race conditions 
lead to data corruption. Data corruption leads to fear... you 
know the rest. 

It all comes down to one potentially deadly scenario: two or 
more threads have access to a single object’s data. In other 
words, methods executing on two different stacks are both 
calling, say, getters or setters on a single object on the heap. 

It’s a whole ‘left-hand-doesn’t-know-what-the-right-hand- 
is-doing’ thing. Two threads, without a care in the world, 
humming along executing their methods, each thread 
thinking that he is the One True Thread. The only one 
that matters. After all, when a thread is not running, and in 
runnable (or blocked) it’s essentially knocked unconscious. 
When it becomes the currently-running thread again, it doesn’t 
know that it ever stopped. 
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networking and threads 



Marriage in Trouble. 

Can this couple be saved? 

Next , on a very special Dr. Steve Show 

[Transcript from episode #42] 

Welcome to the Dr. Steve show. 




We’ve got a story today that’s centered around the top two reasons why 
couples split up— finances and sleep. 

Today’s troubled pair, Ryan and Monica, share a bed and a 
bank account. But not for long if we can’t find a solution. The 
problem? The classic “two people— one bank account” thing. 

Here’s how Monica described it to me: 

“Ryan and I agreed that neither of us will overdraw the checking account. 
So the procedure is, whoever wants to withdraw money must check the 
balance in the account before making the withdrawal. It all seemed so 
simple. But suddenly we’re bouncing checks and getting hit with overdraft 
fees! 

I thought it wasn’t possible, I thought our procedure was safe. But then 
this happened: 




^ Victim 

t, W ,' tw ° P fo P le ’ 

aUo ^i Problem. 



Ryan needed $50, so he checked the balance in the account, 
and saw that it was $100. No problem. So, he plans to 
withdraw the money. But first he falls asleep! 

And that’s where I come in, while Ryan’s still asleep, and 
now I want to withdraw $100. 1 check the balance, and 
it’s $100 (because Ryan’s still asleep and hasn’t yet made 
his withdrawal), so I think, no problem. So I make the 
withdrawal, and again no problem. But then Ryan wakes up, 
completes his withdrawal, and we’re suddenly overdrawn! He didn’t 
even know that he fell asleep, so he just went ahead and completed his 
transaction without checking the balance again. You’ve got to help us Dr. 
Steve!” 




"fya* {alb ad«? 
he tbetks -tbe balante 
UlV>eW>"* kesit>e 

w?) he \mmediaW Y * akes 

+he Withdraw xitkowt 
thefcki*^ tke balance a^ai*- 



Is there a solution? Are they doomed? We can’t stop Ryan from falling 
asleep, but can we make sure that Monica can’t get her hands on the bank 
account until after he wakes up? 

Take a moment and think about that while we go to a commercial break. 
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Ryan and Monica code 



The Ryan and Monica problem, in code 



The following example shows what can happen when two 
threads (Ryan and Monica) share a single object (the bank 
account) . 

The code has two classes, BankAccount, and 
MonicaAndRyanJob. The MonicaAndRyanJob class 
implements Runnable, and represents the behavior that Ryan 
and Monica both have — checking the balance and making 
withdrawals. But of course, each thread falls asleep in between 
checking the balance and actually making the withdrawal. 

The MonicaAndRyanJob class has an instance variable of type 
BankAccount., that represents their shared account. 

The code works like this: 



BankAccount 

int balance 

getBalance() 

withdrawQ 



(7) Make one instance of RyanAndMonicaJob. 



Runnable 



T 



RyanAndMonicaJob 

BankAccount account 
run() 

make Withdrawal) 



The RyanAndMonicaJob class is the Runnable (the job to do), 
and since both Monica and Ryan do the same thing (check 
balance and withdraw money), we need only one instance. 

RyanAndMonicaJob the Job = new RyanAndMonica Job ( ) ; 



(5) Make two threads with the same Runnable 

(the RyanAndMonicaJob instance) 



In the run() method, do 
exactly what Ryan and 
Monica would do — check 
the balance and, if 
there’s enough money, 
make the withdrawal. 



Thread one = new Thread (the Job) ; 
Thread two = new Thread (the Job) ; 



( 3 ) Name and start the threads 

one . setName ( "Ryan" ) ; 
two . setName ( "Monica" ) ; 
one . start () ; 
two . start () ; 

( 4 ) Watch both threads execute the run() method 

(check the balance and make a withdrawal) 



This should protect 
against overdrawing the 
account. 

Except... Ryan and 
Monica always fall 
asleep afte r they 
check the balance but 
before they finish the 
withdrawal. 



One thread represents Ryan, the other represents Monica. 

Both threads continually check the balance and then make a 
withdrawal, but only if it's safe! 
if (account .getBalance () >= amount) { 
try { 

Thread. sleep (500) ; 

} catch ( InterruptedException ex) {ex .printStackTrace () ; } 
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networking and threads 



The Ryan and Monica example 

class BankAccount { 

private int balance = 100; ^ 



public int getBalance() 
return balance; 



{ 



V>a\a*vte ? 100 ' 



public void withdraw (int amount) 
balance = balance - amount; 



public class RyanAndMonicaJob implements Runnable { 

private BankAccount account = new BankAccount ( ) ; ^ 

public static void main (String [] args) { 

RyanAndMonicaJob the Job = new RyanAndMonicaJob ( ) ; 
Thread one = new Thread (the Job) ; 

Thread two = new Thread (the Job) ; 4 /tyake £vvo ‘thread 






one . setName ( "Ryan" ) ; 
two . setName ("Monica' 
one. start () ; 
two. start () ; 



) ; 



Mb tKmcad 

treads will b c ( 



} 



public void run ( ) { 

for (int x = 0; x < 10; x++) { 

makeWi thdrawl (10) ; 
if (account. getBalance () < 0) 
System . out . println ( "Overdrawn ! ' 

} 

} 



{ 






X tkc 
sec 



) ; 



i\\t attow t » s overdrawn- 



} 



private void makeWi thdrawal (int amount) { 
if (account .getBalance () >= amount) { 

System . out . println (Thread . currentThread ( ) . getName ( ) + " 
try { 

System . out . println (Thread . currentThread ( ) . getName ( ) 
Thread. sleep (500) ; 

} catch ( InterruptedException ex) { ex . prints tackTrace ( ) 
System. out. pr in tin (Thread. currentThread () . getName () + 
account . withdraw (amount) ; 

System . out . println (Thread . currentThread ( ) . getName ( ) + 



Chedk the amount baUte, a»d it 
enough money, we just print a message- It there I 
enough, we go to sleep, then wake u F and do^plete 
the withdrawal, just like Ryan did 



is about to withdraw") , 



is going to sleep") , 



} 

woke up . " ) 



completes the wi thdrawl") 



} 

else { 

System . out . println ( ' 



Sorry, not enough for " + Thread. currentThread () . getName ()) , 



pu£ ih a buhdb o( pH h l slol- / 



■ runs. 
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Ryan and Monica output 



d'd ^ w,s 
Via \>? e ^ 



File Edit Window Help Visa 



Ryan is about to withdraw 
Ryan is going to sleep 
Monica woke up. 

Monica completes the withdrawl 
Monica is about to withdraw 
Monica is going to sleep 
Ryan woke up. 

Ryan completes the withdrawl 
Ryan is about to withdraw 
Ryan is going to sleep 
Monica woke up. 

Monica completes the withdrawl 
Monica is about to withdraw 
Monica is going to sleep 
Ryan woke up. 

Ryan completes the withdrawl 
Ryan is about to withdraw 
Ryan is going to sleep 
Monica woke up. 

Monica completes the withdrawl 
Sorry, not enough for Monica 

Sorry, not enough for Monica 

Sorry, not enough for Monica 

Sorry, not enough for Monica 

Sorry, not enough for Monica 

Ryan woke up. 

Ryan completes the withdrawl 
Overdrawn ! 

Sorry, not enough for Ryan 
Overdrawn ! 

Sorry, not enough for Ryan 
Overdrawn ! 

Sorry, not enough for Ryan 
Overdrawn ! 



The makeWithdrawal() method 
always checks the balance 
before making a withdrawal, 
but still we overdraw the 
account. 

Here’s one scenario: 

Ryan checks the balance, sees that 
there’s enough money, and then falls 
asleep. 

Meanwhile, Monica comes in and checks 
the balance. She, too, sees that there’s 
enough money. She has no idea that 
Ryan is going to wake up and complete a 
withdrawal. 

Monica falls asleep. 

Ryan wakes up and completes his 
withdrawal. 

Monica wakes up and completes her 
withdrawal. Big Problem! In between the 
time when she checked the balance and 
made the withdrawal, Ryan woke up and 
pulled money from the account. 

Monica’s check of the account was 
not valid, because Ryan had already 
checked and was still in the middle of 
making a withdrawal. 

Monica must be stopped from getting 
into the account until Ryan wakes up and 
finishes his transaction. And vice-versa. 
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networking and threads 



They need a lock for account access! 



The lock works like this: 



(T) There's a lock associated with the bank 
account transaction (checking the balance 
and withdrawing money). There's only 
one key, and it stays with the lock until 
somebody wants to access the account. 




The bank account 
transaction is 
unlocked when 
nobody is using 
the account. 



(5) When Ryan wants to access the bank 

account (to check the balance and withdraw 
money), he locks the lock and puts the key 
in his pocket. Now nobody else can access 
the account, since the key is gone. 




When Ryan 
wants to access 
the account, he 
secures the lock 
and takes the key. 



(3) Ryan keeps the key in his pocket until he 
finishes the transaction. He has the only 
key, so l^owca can't access the account 
(or the checkbook) until Ryan unlocks the 
account and returns the key. 

Now, even if Ryan falls asleep after he 
checks the balance, he has a guarantee 
that the balance will be the same when he 
wakes up, because he kept the key while he 
was asleep! 




When Ryan is 
finished, he 
unlocks the lock 
and returns the 
key. Now the key 
is available for 
Monica (or Ryan 
again) to access 
the account. 
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using synchronized 



We need the wakeWithdrawal ( ) method 
to row as owe atomic thing. 

We need to make sure that once a thread enters the 
makeWithdrawal() method, it must be allowed to finish the method 
before any other thread can enter. 

In other words, we need to make sure that once a thread has 
checked the account balance, that thread has a guarantee that it can 
wake up and finish the withdrawal before any other thread can check the 
account balance! 

Use the synchronized keyword to modify a method so that only 
one thread at a time can access it. 

That’s how you protect the bank account! You don’t put a lock on 
the bank account itself; you lock the method that does the banking 
transaction. That way, one thread gets to complete the whole 
transaction, start to finish, even if that thread falls asleep in the 
middle of the method! 

So if you don’t lock the back account, then what exactly is locked? Is 
it the method? The Runnable object? The thread itself? 

We’ll look at that on the next page. In code, though, it’s quite 
simple — just add the synchronized modifier to your method 
declaration: 





The synchronized 

keyword means that 
a thread needs a key 
in order to access the 
synchronized code. 

To protect your data 
(like the bank account), 
synchronize the 
methods that act on 
that data. 



private synchronized void makeWithdrawal (int amount) { 




is about to withdraw") , 
is going to sleep") , 



if (account. getBalance () >= amount) { 

System . out . println (Thread . currentThread ( ) . getName ( ) + 
try { 

System . out . println (Thread . currentThread ( ) . getName ( ) + 

Thread. sleep (500) ; 

} catch (InterruptedException ex) { ex. prints tackTrace () ; } 

System . out . println (Thread . currentThread ( ) . getName ( ) + " woke up . " ) ; 
account . withdraw (amount) ; 

Sy stem. out. println (Thread. cur rentThread() .getName () + " completes the withdrawl") , 
} else { 

System . out . println ( "Sorry , not enough for " + Thread . currentThread ( ) . getName ( ) ) ; 



} 



(Nofc (or you physics-savvy readers: yes, -the Convention o( us'm^ -the word 'a-tom'iC* here does no- t re-PleC-t 
-the whole subatomic parcticle thin<y Think Newton, not Einstein, when you hear the word 'atom'll in the 
Content o( threads or transactions. Hey, its not OUR Convention. \( VVE were in charge, we’d apply 
Heisenbergs Uncertainty Principle to pretty much everything related to threads.) 
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networking and threads 



Using an object's lock 

Every object has a lock. Most of the time, the 
lock is unlocked, and you can imagine a virtual 
key sitting with it. Object locks come into play 
only when there are synchronized methods. 
When an object has one or more synchronized 
methods, a thread can enter a synchronized 
method only if the thread can get the key to the 
object’s lock! 

The locks are not per method, they 
are per object. If an object has two 
synchronized methods, it does not 
simply mean that you can’t have two 
threads entering the same method. It 
means you can’t have two threads entering 
any of the synchronized methods. 

Think about it. If you have multiple 
methods that can potentially act on an 
object’s instance variables, all those methods 
need to be protected with synchronized. 

The goal of synchronization is to protect 
critical data. But remember, you don’t lock the 
data itself, you synchronize the methods that 
access that data. 

So what happens when a thread is cranking 
through its call stack (starting with the run() 
method) and it suddenly hits a synchronized 
method? The thread recognizes that it needs 
a key for that object before it can enter the 
method. It looks for the key (this is all handled 
by the JVM; there’s no API in Java for accessing 
object locks), and if the key is available, the 
thread grabs the key and enters the method. 

From that point forward, the thread hangs on 
to that key like the thread’s life depends on 
it. The thread won’t give up the key until it 
completes the synchronized method. So while 
that thread is holding the key, no other threads 
can enter any of that object’s synchronized 
methods, because the one key for that object 
won’t be available. 





Every Java object has a lock. 
A lock has only one key. 

Most of the time, the lock is 
unlocked and nobody cares. 

But if an object bas 
synchronized methods, a 
thread can enter one of tbe 
synchronized methods ONLY 
if the key for the object’ S lock 
is available. In other words, 
only if another thread hasn’t 
already grabbed the one key. 
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synchronization matters 



The dreaded "lost Update" problem 



Here’s another classic concurrency problem, that comes from the database world. It’s 
closely related to the Ryan and Monica story, but we’ll use this example to illustrate a few 
more points. 

The lost update revolves around one process: 

Step 1 : Get the balance in the account 

int i = balance; 

Step 2 : Add 1 to that balance 

balance = i + 1; 

The trick to showing this is to force the computer to take two steps to complete the change 
to the balance. In the real world, you’d do this particular move in a single statement: 

balance++ ; 

But by forcing it into two steps, the problem with a non-atomic process will become clear. 
So imagine that rather than the trivial “get the balance and then add 1 to the current 
balance” steps, the two (or more) steps in this method are much more complex, and 
couldn’t be done in one statement. 

In the “Lost Update” problem, we have two threads, both trying to increment the balance. 

class TestSync implements Runnable { 



private int balanced- 

public void run() { 

for (int i = 0; i < 50; i++) { 
increment () ; 

Sy s tern . out . pr intln ( "balance d 



balance) ; 



v,a\a^ c ovx 



} 



} 



public void increment () 
int i = balanced- 
balance = i + 1 d ‘4 

} 



^ Clrcs -the drudial t>aUl u t . 

TIMP 'c° \ ht X7Ti ihe ba,a ^ *7 

J7/WE /^£, u . °+ balance was ftj THE 



public class TestSyncTest { 

public static void main ( String [] args) { 
TestSync job = new TestSync () ; 

Thread a = new Thread (job) ; 

Thread b = new Thread (job) ; 

a . start () ; 

b. start () ; 
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networking and threads 



Let's run this code... 



(?) Thread A runs for awhile 




Put the value of balance into variable i. 
Balance is 0, so i is now 0. 

Set the value of balance to the result of i + 1 . 
Now balance is 1 . 

Put the value of balance into variable i. 
Balance is 1 , so i is now 1 . 

Set the value of balance to the result of i + 1 . 
Now balance is 2. 



(5) Thread B runs for awhile 




Put the value of balance into variable i. 
Balance is 2, so i is now 2. 

Set the value of balance to the result of i + 1 
Now balance is 3. 

Put the value of balance into variable i. 
Balance is 3, so i is now 3. 

[now thread B is sent back to runnable, 
before it sets the value of balance to 4] 



(3) Thread A runs again, picking up where it left off 




Put the value of balance into variable i. 
Balance is 3, so i is now 3. 

Set the value of balance to the result of i + 1 
Now balance is 4. 

Put the value of balance into variable i. 
Balance is 4, so i is now 4. 

Set the value of balance to the result of i + 1 
Now balance is 5. 



(4) Thread B runs again, and picks up exactly where it left off! 

Set the value of balance to the result of i + 1 . 

Now balance is 4. 

'ikes!! 

Thread A undated ^ ^ 

now 3 tame badk and stewed 
on i op o£ the update A "^de, 
as A's *?date never happened. 






We lost the last updates 
that Thread A made! 

Thread B had previously 
done a ‘read’ of the value 
of balance, and when B 
woke up, it just kept going 
as if it never missed a beat. 
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synchronizing methods 



Make the incrementQ method atomic. 
Synchronize it! 




Synchronizing the increment () method solves the “Lost 
Update” problem, because it keeps the two steps in the method 
as one unbreakable unit. 



public synchronized void increment () { 

int i = balanced- 
balance = i + 1; 

} 



Once a thread enters 
the method, we have 
to make sure that all 
the steps in the method 
complete (as one 
atomic process) before 
any other thread can 
enter the method. 



Dunjl^t^uestions 

% Sounds like it's a good idea to synchronize 
everything, just to be thread-safe. 

A- 

Jr \ m Nope, it's not a good idea. Synchronization doesn't 
come for free. First, a synchronized method has a certain 
amount of overhead. In other words, when code hits a 
synchronized method, there's going to be a performance hit 
(although typically, you'd never notice it) while the matter of 
"is the key available?" is resolved. 

Second, a synchronized method can slow your program 
down because synchronization restricts concurrency. In 
other words, a synchronized method forces other threads to 
get in line and wait their turn. This might not be a problem 
in your code, but you have to consider it. 

Third, and most frightening, synchronized methods can lead 
to deadlock! (See page 516.) 

A good rule of thumb is to synchronize only the bare 
minimum that should be synchronized. And in fact, you 
can synchronize at a granularity that's even smaller than 
a method. We don't use it in the book, but you can use the 
synchronized keyword to synchronize at the more fine- 
grained level of one or more statements, rather than at the 
whole-method level. 
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public void go ( ) { 

doStuff () ; 



doStu-f-fO doesn’t need to 
be syy\tb\roniz-ed, so v/C don Z 
syntWonwt the whole method- 




have to Provide r , d « £, ?*>tion, you 

Although -there ° 

"ill ^l-ost layt Llr WJys V° il ‘ V*> 

object (ihis). Thatl the°T* °V^ e , ^en-fc 



Head First Java, 2nd Edition. Head First Java, 2nd Edition, ISBN: 0596009208 

Prepared for e.simons@icarin.fiuc.org, Eduard Simons 

Copyright © 2005 Bert Bates and Kathy Sierra. This PDF is made available for personal use only during the relevant subscription term, subject to the Safari Terms of Service. Any other use 
requires prior written consent from the copyright owner. Unauthorized use, reproduction and/or distribution are strictly prohibited and violate applicable laws. All rights reserved. 





networking and threads 



(l) Thread 

* 




A runs for awhile 

Attempt to enter the increment() method. 

The method is synchronized, so get the key for this object 
Put the value of balance into variable i. 

Balance is 0, so i is now 0. 

Set the value of balance to the result of i + 1 . 

Now balance is 1 . 

Return the key (it completed the increment() method). 
Re-enter the increment() method and get the key. 

Put the value of balance into variable i. 

Balance is 1 , so i is now 1 . 



[now thread A is sent back to runnable, but since it has not 
completed the synchronized method, Thread A keeps the key] 



( 2 ) Thread B is selected to run 

£ 

t Attempt to enter the increment) method. The method is 
synchronized, so we need to get the key. 

The key is not available. 

[now thread B is sent into a ‘object lock not available lounge] 



(3) Thread A runs again, picking up where it left off 
^ (remember, it still has the key) 

Set the value of balance to the result of i + 1 . 

Now balance is 2. 

Return the key. 

[now thread A is sent back to runnable, but since it 
has completed the increment () method, the thread 
does NOT hold on to the key] 




(4) Thread 




B is selected to run 

Attempt to enter the increment() method. The method is 
synchronized, so we need to get the key. 

This time, the key IS available, get the key. 

Put the value of balance into variable i. 

[continues to run...] 
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thread deadlock 



The deadly side of synchronization 

Be careful when you use synchronized code, because nothing 
will bring your program to its knees like thread deadlock. 
Thread deadlock happens when you have two threads, both of 
which are holding a key the other thread wants. There’s no way 
out of this scenario, so the two threads will simply sit and wait. 
And wait. And wait. 

If you’re familiar with databases or other application servers, 
you might recognize the problem; databases often have a 
locking mechanism somewhat like synchronization. But a 
real transaction management system can sometimes deal with 
deadlock. It might assume, for example, that deadlock might 
have occurred when two transactions are taking too long to 
complete. But unlike Java, the application server can do a 
“transaction rollback” that returns the state of the rolled-back 
transaction to where it was before the transaction (the atomic 
part) began. 

Java has no mechanism to handle deadlock. It won’t even know 
deadlock occurred. So it’s up to you to design carefully. If you 
find yourself writing much multithreaded code, you might 
want to study “Java Threads” by Scott Oaks and Henry Wong 
for design tips on avoiding deadlock. One of the most common 
tips is to pay attention to the order in which your threads are 
started. 



All it takes for 
deadlock are two 
objects and two 
threads. 




A simple deadlock scenario: 




Thread A enters a 
synchronized method 
of object foo, and gets 
the key. 




Thread A goes to 
sleep, holding the 
foo key. 




^ Thread B enters a 

synchronized method 
of object bar, and gets 
1 the key. 




f bar) 



Thread B tries to enter 
a synchronized method 
of object foo, but can’t 
get that key (because 
A has it). B goes 
to the waiting lounge, 
until the foo key is 
available. B keeps the 
bar key. 




Thread A wakes up (still 
holding the foo key) 
and tries to enter a 
synchronized method on 
object bar, but can’t get 
that key because B has 
it. A goes to the waiting 
lounge, until the bar key is 
available (it never will be!) 

Thread A can’t run until 
it can get the bar key, 
but B is holding the bar 
key and B can’t run until it 
gets the foo key that A is 
holding and... 
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networking and threads 



BULLET POINTS 

■ The static Thread. sleep() method forces a thread to leave the 
running state for at least the duration passed to the sleep method. 
Thread.sleep(200) puts a thread to sleep for 200 milliseconds. 

■ The sleep() method throws a checked exception (InterruptedException), 
so all calls to sleep() must be wrapped in a try/catch, or declared. 

■ You can use sleep() to help make sure all threads get a chance to run, 
although there’s no guarantee that when a thread wakes up it’ll go to the 
end of the runnable line. It might, for example, go right back to the front. 

In most cases, appropriately-timed sleep() calls are all you need to keep 
your threads switching nicely. 

■ You can name a thread using the (yet another surprise) setName() 
method. All threads get a default name, but giving them an explicit name 
can help you keep track of threads, especially if you’re debugging with 
print statements. 

■ You can have serious problems with threads if two or more threads have 
access to the same object on the heap. 

■ Two or more threads accessing the same object can lead to data 
corruption if one thread, for example, leaves the running state while still 
in the middle of manipulating an object’s critical state. 

■ To make your objects thread-safe, decide which statements should be 
treated as one atomic process. In other words, decide which methods 
must run to completion before another thread enters the same method 
on the same object. 

■ Use the keyword synchronized to modify a method declaration, 
when you want to prevent two threads from entering that method. 

■ Every object has a single lock, with a single key for that lock. Most of the 
time we don’t care about that lock; locks come into play only when an 
object has synchronized methods. 

■ When a thread attempts to enter a synchronized method, the thread 
must get the key for the object (the object whose method the thread 
is trying to run). If the key is not available (because another thread 
already has it), the thread goes into a kind of waiting lounge, until the key 
becomes available. 

■ Even if an object has more than one synchronized method, there is still 
only one key. Once any thread has entered a synchronized method on 
that object, no thread can enter any other synchronized method on the 
same object. This restriction lets you protect your data by synchronizing 
any method that manipulates the data. 
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final chat client 



New and improved SimpleChatClient 



Way back near the beginning of this chapter, we built the SimpleChatClient that could send 
outgoing messages to the server but couldn’t receive anything. Remember? That’s how we 
got onto this whole thread topic in the first place, because we needed a way to do two things 
at once: send messages to the server (interacting with the GUI) while simultaneously reading 
incoming messages from the server, displaying them in the scrolling text area. 



import j ava . io . * ; 
import j ava . net . * ; 
import j ava . util . * ; 
import j avax . swing . * ; 
import j ava . awt . * ; 
import j ava . awt . event . 



io ihis chaplev. 

Put hot yet- 



public class SimpleChatClient { 

JTextArea incoming; 
JTextField outgoing; 
BufferedReader reader; 
PrintWriter writer; 

Socket sock; 



public static void main ( String [] args) { 

SimpleChatClient client = new SimpleChatClient () 
client . go ( ) ; 

} 

public void go() { 



before. 

nv'ir 



JFrame frame = new JFrame ("Ludicrously Simple Chat Client"); 

JPanel mainPanel = new JPanel ( ) ; 
incoming = new JTextArea ( 1 5 , 5 0 ) ; 
incoming . setLineWrap (true) ; 
incoming . setWrapStyleWord ( true) ; 
incoming. setEdi table (false) ; 

JScrollPane qScroller = new JScrollPane (incoming) ; 

qScroller . setVerticalScrollBarPolicy (ScrollPaneConstants . VERTICAL_SCROLLBAR_ALWAYS) ; 
qScroller . setHorizontalScrollBarPolicy (ScrollPaneConstants . HORI ZONTAL_SCROLLBAR_NEVER) , 
outgoing = new JTextField (20) ; 

JButton sendButton = new JButton ("Send") ; 
sendButton . addActionListener (new SendButtonListener ( ) ) , 
mainPanel . add (qScroller) ; 
mainPanel . add (outgoing) ; 
mainPanel . add ( sendButton) ; 
setUpNetworking ( ) ; 



Thread readerThread = new Thread (new IncomingReader ( ) ) , 
reader Thread . start ( ) ; 



frame . getContentPane ( ) . add (BorderLayout . CENTER , mainPanel ) , 
frame . setSize (400 , 500) ; 
frame . setVisible (true) ; 



We ire staging a new 
'►>9 a new mnetr d ass as 
the Runnable (job) lh e 

W The dead', job - 
^ read ^ lh e 

***et stream, dis P layin« 

►>y ihComing messages in the 
scrolling text area. 



} // close go 



518 chapter 15 



Head First Java, 2nd Edition. Head First Java, 2nd Edition, ISBN: 0596009208 

Prepared for e.simons@icarin.fiuc.org, Eduard Simons 

Copyright © 2005 Bert Bates and Kathy Sierra. This PDF is made available for personal use only during the relevant subscription term, subject to the Safari Terms of Service. Any other use 
requires prior written consent from the copyright owner. Unauthorized use, reproduction and/or distribution are strictly prohibited and violate applicable laws. All rights reserved. 




networking and threads 



private void setUpNetworking ( ) { 

try { 



sock = new Socket ("127 . 0 . 0 . 1 " , 5000); 

InputStreamReader streamReader = new I nputStreamReader (sock. get Inputs tream() ) ; 
reader = new BufferedReader (streamReader) ; 
writer = new PrintWriter (sock . getOutputStreai 



public class SendButtonListener implements ActionListener { 
public void actionPerf ormed (ActionEvent ev) { 
try { 

writer . println (outgoing . getText ( ) ) ; 



} 

outgoing . setText ( " " ) ; 
outgoing . requestFocus ( ) ; 

} 

} // close inner class 



incoming. append (message + "\n") ; 



} catch (Exception ex) {ex.printStackTrace () ; } 

} // close run 
} // close inner class 



} // close outer class 



} // close setUpNetworking 



System. out .println ("networking established") 
} catch ( IOException ex) { 



ex . prints tackTrace ( ) ; 

} 




writer .flush () ; 




} catch (Exception ex) { 
ex . prints tackTrace ( ) ; 



scv-vcv-. 



public class IncomingReader implements Runnable { 
public void run() { 



TWis is v/l 



ti'read does!! 



String message; 
try { 




while ((message = reader . readLine () ) != null) { 

System. out .println ("read " + message); 



} // close while 
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chat server code 




Read|-fcake 
Cade „ 



The really really simple Chat Server 



You can use this server code for both versions of the Chat Client. Every possible 
disclaimer ever disclaimed is in effect here. To keep the code stripped down to the 
bare essentials, we took out a lot of parts that you’d need to make this a real server. 
In other words, it works, but there are at least a hundred ways to break it. If you 
want a Really Good Sharpen Your Pencil for after you’ve finished this book, come 
back and make this server code more robust. 

Another possible Sharpen Your Pencil, that you could do right now, is to annotate 
this code yourself. You’ll understand it much better if you work out what’s 
happening than if we explained it to you. Then again, this is Ready-bake code, 
so you really don’t have to understand it at all. It’s here just to support the two 
versions of the Chat Client. 



import j ava . util . * ; 

public class VerySimpleChatServer { 

ArrayList clientOutputStreams ; 

public class ClientHandler implements Runnable { 

BufferedReader reader; 

Socket sock; 

public ClientHandler (Socket clientSocket) { 
try { 

sock = clientSocket; 

Inputs treamReader isReader = new Inputs treamReader (sock .get Inputs tream() ) ; 
reader = new BufferedReader (isReader) ; 

} catch (Exception ex) {ex . printStackTrace () ; } 

} // close constructor 

public void run() { 

String message; 
try { 

while ((message = reader . readLine () ) != null) { 

System. out. pr in tin ("read " + message) ; 
tellEveryone (message) ; 

} // close while 

} catch (Exception ex) {ex . printStackTrace () ; } 

} // close run 
} // close inner class 



import j ava . io . * ; 
import j ava . net . * ; 



To run the chat client, you need two 
terminals. First, launch this server 
from one terminal, then launch the 
client from another terminal 
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networking and threads 



public static void main ( String [] args) { 
new VerySimpleChatServer () .go() ; 

} 

public void go() { 

clientOutputStreams = new ArrayList() ; 
try { 

ServerSocket serverSock = new Server Socket (5000) ; 
while (true) { 

Socket clientSocket = serverSock . accept () ; 

PrintWriter writer = new PrintWriter (clientSocket .getOutputStream() ) ; 
clientOutputStreams . add (writer) ; 

Thread t = new Thread (new ClientHandler (clientSocket) ) ; 
t . start () ; 

System. out .println ("got a connection") ; 

} 

} catch (Exception ex) { 
ex . prints tackTrace ( ) ; 

} 

} // close go 

public void tellEveryone (String message) { 

Iterator it = clientOutputStreams . iterator () ; 
while (it .hasNext () ) { 

try { 

PrintWriter writer = (PrintWriter) it. next () ; 
writer . println (message) ; 
writer . flush ( ) ; 

} catch (Exception ex) { 

ex . printStackTrace ( ) ; 

} 

} // end while 

} // close tellEveryone 
} // close class 
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synchronization questions 



Dunfl? r t^uestic>ns 




What about protecting static 
variable state? If you have static 
methods that change the static variable 
state, can you still use synchronization? 

A. 


^ Why don't you just synchronize 
all the getters and setters from the 
class with the data you're trying to 
protect? Like, why couldn't we have 
synchronized just the checkBalanceO 
and withdraw() methods from class 


Yes! Remember that static 
methods run against the class and not 
against an individual instance of the class. 
So you might wonder whose object's lock 
would be used on a static method? After 
all, there might not even be any instances 
of that class. Fortunately, just as each 
object has its own lock, each loaded class 
has a lock. That means that if you have 
three Dog objects on your heap, you have 
a total of four Dog-related locks. Three 
belonging to the three Dog instances, 
and one belonging to the Dog class itself. 
When you synchronize a static method, 
Java uses the lock of the class itself. So if 
you synchronize two static methods in a 
single class, a thread will need the class 
lock to enter either of the methods. 


BankAccount, instead of synchronizing 
the makeWithdrawalO method from 
the Runnable's class? 

A* 

Jr \ m Actually, we should have 
synchronized those methods, to prevent 
other threads from accessing those 
methods in other ways. We didn't bother, 
because our example didn't have any 
other code accessing the account. 

But synchronizing the getters 
and setters (or in this case the 
checkBalanceO and withdrawO) isn't 
enough. Remember, the point of 
synchronization is to make a specific 
section of code work ATOMICALLY. In 
other words, it's not just the individual 
methods we care about, it's methods 


^ What are thread priorities? I've 
heard that's a way you can control 
scheduling. 

A 


that require more than one step to 
complete ! Think about it. If we had not 
synchronized the makeWithdrawalO 
method, Ryan would have checked the 
balance (by calling the synchronized 


^1- Thread priorities might help 
you influence the scheduler, but they 
still don't offer any guarantee. Thread 
priorities are numerical values that tell 
the scheduler (if it cares) how important a 
thread is to you. In general, the scheduler 
will kick a lower priority thread out of the 
running state if a higher priority thread 
suddenly becomes runnable. But... one 
more time, say it with me now, "there 
is no guarantee." We recommend that 
you use priorities only if you want to 
influence performance, but never, ever 
rely on them for program correctness. 


checkBalanceO), and then immediately 
exited the method and returned the key! 

Of course he would grab the key again, 
after he wakes up, so that he can call 
the synchronized withdrawO method, 
but this still leaves us with the same 
problem we had before synchronization! 
Ryan can check the balance, go to sleep, 
and Monica can come in and also check 
the balance before Ryan has a chance to 
wakes up and completes his withdrawal. 

So synchronizing all the access methods 
is probably a good idea, to prevent 
other threads from getting in, but you 
still need to synchronize the methods 
that have statements that must execute 
as one atomic unit. 
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networking and threads 




Code Kitcken 




It connects to a simple MusicServer so tkat you can 
send and receive keat patterns with otker clients. 

Tke code is really long, so tke complete listing is 
actually in Appendix A. 
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exercise: Code Magnets 





Code Magnets 

A working Java program is scrambled up on the fridge. Can 
you add the code snippets on the next page to the empty 
classes below, to make a working Java program that pro- 
duces the output listed? Some of the curly braces fell on the 
floor and they were too small to pick up, so feel free to add as 
many of those as you need! 



public class TestThreads { 



class ThreadOne 



class Accum { 



class ThreadTwo 



I File Edit Window Help Sewing 



% java TestThreads 
one 98098 
two 98099 



Bonus Question: Why do you think we used the 
modifiers we did in the Accum class? 
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networking and threads 



Code Magnets, continued., 



Thread one = new Thread(tl); 




} rat.chdnterruptedException ex) { }j |rhreadTwo t2 new ThreadTwo ( ) , J 



return counter!; ' counter + add; 




implements Run 


nable { 




one. start ( ) ; I 




Thread. sleep) 


(50); 





public static Accum getAccum( ) { 













private Accum ( ) { }| 


1 ThreadOne tl = new ThreadOneOjj 
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exercise solutions 



public class TestThreads { 

public static void main (String [] args ) { 
ThreadOne tl = new ThreadOne(); 
ThreadTwo t2 = new ThreadTwo(); 

Thread one = new Thread(tl); 

Thread two = new Thread(t2); 
one. start ( ) ; 
two. start ( ) ; 



} 

class Accum { 

private static Accui 
private int counter 

private Accum ( ) { } 



Excise Solutions 





,s \yvtkpf 



public static Accum getAccum( ; 
return a; 

} 



public void updateCounter ( int add) { 
counter += add; 

} 

public int getCount( ) { 
return counter; 

} 

} 

class ThreadOne implements Runnable { 

Accum a = Accum. getAccum( ) ; 
public void run( ) { 

for (int x=0; x < 98; x++) { 
a . updateCounter (1000); 
try { 

Thread. sleep( 50 ) ; 

} catch ( InterruptedException ex) { } 

} 

System. out .println( "one "+a. getCount ( ) ) ; 

} 



Threads from two different classes are updating 
the same object in a third class, because both 
threads are accessing a single instance of Accum. 
The line of code: 

private static Accum a = new Accum( ); creates a 
static instance of Accum (remember static means 
one per class), and the private constructor in 
Accum means that no one else can make an Accum 
object. These two techniques (private constructor 
and static getter method) used together, create 
what's known as a 'Singleton' - an 00 pattern to 
restrict the number of instances of an object 
that can exist in an application. (Usually, there's 
just a single instance of a Singleton— hence the 
name), but you can use the pattern to restrict the 
instance creation in whatever way you choose.) 



class ThreadTwo implements Runnable { 

Accum a = Accum. getAccum( ) ; 
public void run() { 

for (int x=0; x < 99; x++) { 
a . updateCounter ( 1 ) ; 
try { 

Thread. sleep ( 50 ) ; 

} catch ( InterruptedException ex) { } 

} 

System. out .println( "two "+a. getCount ( ) ) 

} 

} 
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networking and threads 




Near-miss at the Airlock 

As Sarah joined the on-board development team’s design review meeting , she gazed out 
the portal at sunrise over the Indian Ocean. Even though the ship’s conference room was 
incredibly claustrophobic, the sight of the growing blue and white crescent overtaking night on 
the planet below filled Sarah with awe and appreciation. 

FlVC^mUte This morning’s meeting was focused on the control systems for the orbiter’s airlocks. 

Mwery As the final construction phases were nearing their end, the number of spacewalks was 
J J scheduled to increase dramatically, and traffic was high both in and out of the ship’s 

airlocks. “Good morning Sarah”, said Tom, “Your timing is perfect, we’re just starting 
the detailed design review.” 

“As you all know”, said Tom, “Each airlock is outfitted with space-hardened GUI 
terminals, both inside and out. Whenever spacewalkers are entering or exiting the orbiter 
they will use these terminals to initiate the airlock sequences.” Sarah nodded, “Tom can 
you tell us what the method sequences are for entry and exit?” Tom rose, and floated to the 
whiteboard, “First, here’s the exit sequence method’s pseudocode”, Tom quickly wrote on the 
board. 

orbiterAirlockExitSequence () 
verifyPortalStatus () ; 
pressurizeAirlock ( ) ; 




openlnnerHatch () ; 
confirmAirlockOccupied ( ) ; 
closelnnerHatch ( ) ; 



decompressAirlock ( ) ; 
openOuterHatch () ; 
confirmAirlockVacated ( ) ; 



closeOuterHatch ( ) ; 

“To ensure that the sequence is not interrupted, we have synchronized all of the 
methods called by the orbiterAirlockExitSequence() method”, Tom explained. “We’d hate to 
see a returning spacewalker inadvertently catch a buddy with his space pants down!” 

Everyone chuckled as Tom erased the whiteboard, but something didn’t feel right 
to Sarah and it finally clicked as Tom began to write the entry sequence pseudocode on the 
whiteboard. “Wait a minute Tom!”, cried Sarah, “I think we’ve got a big flaw in the exit 
sequence design, let’s go back and revisit it, it could be critical!” 

Why did Sarah stop the meeting? What did she suspect? 
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puzzle answers 




What did Sarah know? 

Sarah realized that in order to ensure that the entire exit 
sequence would run without interruption the 

orbiterAirlockExitSequence( ) method needed to 
be synchronized. As the design stood, it would be possible 
for a returning spacewalker to interrupt the Exit Sequence! 
The Exit Sequence thread couldn’t be interrupted in the 
middle of any of the lower level method calls, but it could be 
interrupted in between those calls. Sarah knew that the entire 
sequence should be run as one atomic unit, and if the orbit 
erAirlockExitSequence ( ) method was synchronized, it 
could not be interrupted at any point. 
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1 6 collections and generics 




Data 

structures 



f Sheesh... and all 
this time I could have just let 
Java put things in alphabetical 
order? Third grade really 
sucks. We never learn 
L. anything useful... 



Sorting is a snap in Java. You have all the tools for collecting and manipulating 
your data without having to write your own sort algorithms (unless you're reading this right 
now sitting in your Computer Science 101 class, in which case, trust us — you are SO going to be 
writing sort code while the rest of us just call a method in the Java API). The Java Collections 
Framework has a data structure that should work for virtually anything you'll ever need to do. 
Want to keep a list that you can easily keep adding to? Want to find something by name? Want 
to create a list that automatically takes out all the duplicates? Sort your co-workers by the 
number of times they've stabbed you in the back? Sort your pets by number of tricks learned? 
It's all here... 



this is a new chapter 529 



Head First Java, 2nd Edition. Head First Java, 2nd Edition, ISBN: 0596009208 

Prepared for e.simons@icarin.fiuc.org, Eduard Simons 

Copyright © 2005 Bert Bates and Kathy Sierra. This PDF is made available for personal use only during the relevant subscription term, subject to the Safari Terms of Service. Any other use 
requires prior written consent from the copyright owner. Unauthorized use, reproduction and/or distribution are strictly prohibited and violate applicable laws. All rights reserved. 



sorting a list 



tracking song popularity on your jukebox 

Congratulations on your new job — managing the automated 
jukebox system at Lou’s Diner. There’s no Java inside the 
jukebox itself, but each time someone plays a song, the 
song data is appended to a simple text file. _ — * 




Your job is to manage the data to track song popularity, 
generate reports, and manipulate the playlists. You’re not 
writing the entire app — some of the other software developer/ 
waiters are involved as well, but you’re responsible for managing 
and sorting the data inside the Java app. And since Lou has a thing 
against databases, this is strictly an in-memory data collection. All 
you get is the file the jukebox keeps adding to. Your job is to take it 
from there. 



You’ve already figured out how to read and parse the file, and so far 
you’ve been storing the data in an ArrayList. 



SongList.txt 



Pink Moon/Nick Drake 
Somersault/ Zero 7 
Shiva Moon/Prem Joshua 
Circles/BT 

Deep Channel/Afro Celts 
Passenger/Headmix 
Listen/Tahiti 80 



TW* > s -ty SadU* t.le, 

^ e s. ^ aab- 



Challenge #1 

Sort the songs in alphabetical order 

You have a list of songs in a file, where each line 
represents one song, and the title and artist are 
separated with a forward slash. So it should be simple 
to parse the line, and put all the songs in an ArrayList. 

Your boss cares only about the song titles, so for now 
you can simply make a list that just has the song titles. 

But you can see that the list is not in alphabetical 
order... what can you do? 

You know that with an ArrayList, the elements are 
kept in the order in which they were inserted into the 
list, so putting them in an ArrayList won’t take care of 
alphabetizing them, unless... maybe there’s a sort() 
method in the ArrayList class? 
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collections with generics 



Here's what you have so far without the sort: 



import java. util.*; 
import java.io.*; 

public class Jukeboxl 






ArrayList<String> songList = new ArrayList<String> () ; 



public static void main (String [ ] 
new Jukeboxl () .go () ; 

} 

public void go() { 
getSongs ( ) ; 

System. out .print in (songList) ; 



args) { 



■\\f ar ,d r rmts , 



void getSongs () 

try { 



• .4- ve ad tV* ar>< * 



File file = new File ("SongList . txt" ) ; 

But feredReader reader = new BufferedReader (new FileReader (file) ) ; 
String line = null; 

while ( (line= reader . readLine () ) != null) { 

addSong (line) ; 

} 



} catch (Exception ex) { 
ex.printStackTrace () ; 

} 



} 

void addSong (String lineToParse) { 

String [] tokens = lineToParse . split 
songList . add (tokens [ 0 ] ) ; 




("/"); 






} 



} 










File Edit Window Help Dance 



%java Jukeboxl 

[Pink Moon, Somersault, 

Shiva Moon, Circles, 

Deep Channel, Passenger, 
Listen] 



TKt t 
added to tV* A^Ust 
Ts tte sa,e <rd«r f : jojyre * 

W,tWmtte ov^mal t»tt«W- 
Tte vs deUtelv NOT al ? KabeW! 
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ArrayList API 



Put the ArrayList class does NOT have a sortO method! 

When you look in ArrayList, there doesn’t seem to be any method related to sorting. 
Walking up the inheritance hierarchy didn’t help either — it’s clear that you can’t call a sort 
method on the ArrayList. 




Lviitgchim 



Method Summary 



EUiDJi I 



nf ittu tinaw 
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collections with generics 



I do see a collection class 
called TreeSet... and the docs 
say that it keeps your data 
sorted. I wonder if I should be 
using a TreeSet instead of an 
ArrayList... 




Arraylist is wot the only collection 

Although ArrayList is the one you’ll use most often, 
there are others for special occasions. Some of the key 
collection classes include: 

>► TreeSet 

Keeps the elements sorted and prevents duplicates. 



f wovv-v aooiAA, ^ r J 



> HashMap 

Let’s you store and access elements as name/value pairs. 



y LinkedList 

Designed to give better performance when you insert or delete 
elements from the middle of the collection. (In practice, an 
ArrayList is still usually what you want.) 



>► HashSet 

Prevents duplicates in the collection, and given an element, can 
find that element in the collection quickly. 



> LinkedHashMap 

Like a regular HashMap, except it can remember the order in 
which elements (name/value pairs) were inserted, or it can be 
configured to remember the order in which elements were last 
accessed. 
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Collections.sortQ 



You could use a TreeSet... 

Or you could use the Collections.sortQ method 



If you put all the Strings (the song titles) into a TreeSet instead of 
an ArrayList, the Strings would automatically land in the right place, 
alphabetically sorted. Whenever you printed the list, the elements would 
always come out in alphabetical order. 

And that’s great when you need a set (we’ll 
talk about sets in a few minutes) or when 
you know that the list must always stay 
sorted alphabetically. 

On the other hand, if you don’t need the 
list to stay sorted, TreeSet might be more 
expensive than you need — every time you 
insert into a TreeSet , the TreeSet has to take 
the time to figure out where in the tree the new 
element must go. With ArrayList, inserts can 
be blindingly fast because the new element 
just goes in at the end. 



java.util.Collections 

copy(List destination, List source) 

public static List emptyList() 

public static void f.ll(List listToFill, Object objToFillltWith) 
public static int frequency(Collection c, Object o) 
public static void reverse(List list) 
public static void rotate(List list, int distance) 
public static void shuffle(Listjist) 
public static v oid sort(List list) 



O: But you CAN add something to an 
ArrayList at a specific index instead of just at 
the end — there's an overloaded addO method 
that takes an int along with the element to add. 

So wouldn't it be slower than inserting at the end? 



public static boolei 
II many more metl 



Object oldVal, Object newVal) 



A: 



Yes, it's slower to insert something in an ArrayList 
somewhere other than at the end. So using the overloaded 
add(index, element) method doesn't work as quickly as calling 
the add(element) — which puts the added element at the end. 
But most of the time you use ArrayLists, you won't need to put 
something at a specific index. 



tk... IS a svrio 

» tk. eba . H W(I 

a L,si ' ahd sl ^e AvvayLis-fc 
tk' tut u w Jct , 

AfuayLut IS-A Ut Thinks 
, P “ l r""-fku. 1 you m„ pa,, * 

r‘ yUi ic - 

"to -feakc Li s-fc. 



0? I see there's a LinkedList class, so wouldn't that be better for 
doing inserts somewhere in the middle? At least if I remember my Data 
Structures class from college... 



A: 



Yes, good spot.The LinkedList can be quicker when you insert or 
remove something from the middle, but for most applications, the difference 
between middle inserts into a LinkedList and ArrayList is usually not enough 
to care about unless you're dealing with a huge number of elements. We'll 
look more at LinkedList in a few minutes. 



w j... His is NOT LVie veal Collet W 
Note- t . i y. C y C tv leavm$ 

,lass API; - 

out tV ,e 9 evev\6 ty?e m^ov-at.o 

’ll ... m a -few ?a 






534 chapter 16 



Head First Java, 2nd Edition. Head First Java, 2nd Edition, ISBN: 0596009208 

Prepared for e.simons@icarin.fiuc.org, Eduard Simons 

Copyright © 2005 Bert Bates and Kathy Sierra. This PDF is made available for personal use only during the relevant subscription term, subject to the Safari Terms of Service. Any other use 
requires prior written consent from the copyright owner. Unauthorized use, reproduction and/or distribution are strictly prohibited and violate applicable laws. All rights reserved. 



collections with generics 



Adding ColIcctions.sortO to the Jukebox code 

import java. util.*; 
import java.io.*; 

public class Jukeboxl { 

ArrayList<String> songList = new ArrayList<String> () ; 

public static void main (String [ ] args) { 
new Jukeboxl (). go () ; 

} 



The Collections.SortO 
method sorts a list of 
Strings alphabetically. 



public void go() { 
getSongs ( ) ; 

System. out .print in (songList) ; 

Collections . sort (songList) ; 
System. out .println (songList) 

} 






V.rl aaaV 



void getSongs () { 

try { 

File file = new File ("SongList . txt") ; 

But feredReader reader = new BufferedReader (new FileReader (file) ) ; 
String line = null; 

while ( (line= reader . readLine () ) != null) { 

addSong (line) ; 

} 



} catch (Exception ex) { 
ex.printStackTrace () ; 

} 



void addSong (String lineToParse) { 

String [] tokens = lineToParse . split ("/") ; 
songList . add (tokens [ 0 ] ) ; 



1 1 . jl l. -- i |M i. ’nr i i i i' 

%java Jukeboxl 

[Pink Moon, Somersault, Shiva Moon, Circles, Deep 
Channel, Passenger, Listen] 

[Circles, Deep Channel, Listen, Passenger, Pink 
Moon, Shiva Moon, Somersault] 



tall'mOy sort)- 
A-C-tev talVmOy sortO- 
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sorting your own objects 



Put now you need Song objects, 

Motjust simple Strings. 

Now your boss wants actual Song class instances in the list, not just 
Strings, so that each Song can have more data. The newjukebox 
device outputs more information, so this time the hie will ha \e four- 
pieces (tokens) instead of just two. 

The Song class is really simple, with only one interesting feature — 
the overridden toStringQ method. Remember, the toString() 
method is defined in class Object, so every class in Java inherits the 
method. And since the toString() method is called on an object 
when it’s printed (System.out.println(anObject)), you should 
override it to print something more readable than the default 
unique identifier code. When you print a list, the toStringQ 
method will be called on each object. 

class Song { 

String title; 

String artist 
String rating 
String bpm; 






SongListMore . txt 



Pink Moon/Nick Drake/5/80 
Somersault/Zero 7/4/84 
Shiva Moon/Prem Joshua/6/120 
Circles/BT/5/110 
Deep Channel/Afro Celts/4/120 
Passenger/Headmix/ 4/100 
Listen/Tahiti 80/5/90 



The new song -Pile holds Pour 
attributes instead of just two. 
/U we want All op then, in our 
list, so we need to make a Song 
dass With instande variables Por all 
+our song attributes. 



Song (String t, String a. String r. String b) { 
title = t; 

artist = a; The vaH ables are all set in 

rating = r; the donstrudtor when the 

bpm b; rew Song is dreated- 



public String getTitle() { 
return title; 



public String getArtist() 
return artist; 



public String getRatingO 
return rating; 



The getter methods Por 
the Pour attributes. 



public String getBpm() { 
return bpm; 



public String toStringO { ^ out println^aSong^bjedtV— ^ ^ OU f*° a 

1 System. ou-( 

i=AA+ 7 r ,t: 

t/lCH element in the list. 



return title; 



When you do ou+T -"pt t° T 

tbe toStringO method of 
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collections with generics 



Changing the Jukebox code to use Songs 
instead of Strings 



Your code changes only a little — the hie I/O code is the same, 
and the parsing is the same (String.split()), except this time 
there will be four tokens for each song/line, and all four will be 
used to create a new Song object. And of course the ArrayList 
will be of type <Song> instead of <String>. 



ArrayList<Song> songList = new ArrayList<Song>() ; 

public static void main (String [ ] args) { 
new Jukebox3 ( ) . go ( ) ; 



public void go() { 
getSongs ( ) ; 

System. out .print In (songList) ; 
Collections . sort (songList) ; 
System. out .print In (songList) ; 



void getSongs () { 

try { 

File file = new File ("SongList . txt" ) ; 

But feredReader reader = new BufferedReader (new FileReader (file) ) ; 
String line = null; 

while ( (line= reader . readLine () ) != null) { 

addSong (line) ; 

} 

} catch (Exception ex) { 
ex . printStackTrace () ; 

} 



void addSong (String lineToParse) { 

String [] tokens = lineToParse . split ("/") ; 

Song nextSong = new Song (tokens [0] , tokens [1] , tokens [2], tokens [3]); 
songList . add (nextSong) ; 



import 

import 



public 
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Collections.sortQ 



It won't compile! 

Something’s wrong... the Collections class clearly shows there’s a 
sort() method, that takes a List. 

ArrayList is-a List, because ArrayList implements the List interface, 
so... it should work. 

But it doesn’t! 

The compiler says it can’t find a sort method that takes an 
ArrayList<Song>, so maybe it doesn’t like an ArrayList of Song 
objects? It didn’t mind an ArrayList<String>, so what’s the 
important difference between Song and String? What’s the 
difference that’s making the compiler fail? 



File Edit Window Help Bummer 



% j avac Jukebox3 . j ava 

Jukebox3 . java : 15 : cannot find symbol 

symbol : method sort (java. util . ArrayList<Song>) 

location : class j ava . util . Collections 

Collections . sort (songList) ; 

A 

1 error 



And of course you probably already asked yourself, “What would it 
be sorting on?” How would the sort method even know what made 
one Song greater or less than another Song? Obviously if you want 
the song’s title to be the value that determines how the songs are 
sorted, you’ll need some way to tell the sort method that it needs 
to use the title and not, say, the beats per minute. 

We’ll get into all that a few pages from now, but first, let’s find out 
why the compiler won’t even let us pass a Song ArrayList to the 
sort() method. 
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collections with generics 



WTF? I have no idea how to 
read the method declaration 
on this. It says that sort() 
takes a List<T>, but what is 
T? And what is that big thing 
before the return type? 




The sortO method declaration 

Collections (java 2 Platform SE 5.0) 



| + | £ file:///U5ers/kathy/Publ[c/docs/api/index.html 



" Google 



I 



Method Detail 



sort 

public Btatic^^^xtend^ Compari^Le^ ^^upe^^^^^cid list 

Som the specified list into ascending order, according to the natural ordering of its elements. All 
elements in the list must implement the comparable interface. Furthermore, all elements in the list 
must be mutually comparable (that is, el . compareTo ( e2 ) must not thlOW a ClaesCastException 
for any elements ei and e2 in the list). 



0 



From the API docs (looking up the java. util. Collections class, and scrolling to the sort() 
method), it looks like the sort() method is declared... strangely. Or at least different from 
anything we’ve seen so far. 

That’s because the sort() method (along with other things in the whole collection framework in 
Java) makes heavy use of generics. Anytime you see something with angle brackets in Java source 
code or documentation, it means generics — a feature added to Java 5.0. So it looks like we’ll 
have to learn how to interpret the documentation before we can figure out why we were able to 
sort String objects in an ArrayList, but not an ArrayList of Song objects. 
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generic types 



Generics weans wore type-safety 



We’ll just say it right here — virtually all of the code you write that deals 
with generics will be collection-related code. Although generics can be used 
in other ways, the main point of generics is to let you write type-safe 
collections. In other words, code that makes the compiler stop you 
from putting a Dog into a list of Ducks. 



Before generics (which means before Java 5 . 0 ), the compiler could 
not care less what you put into a collection, because all collection 
implementations were declared to hold type Object. You could put 
anything in any ArrayList; it was like all ArrayLists were declared as 
ArrayList<Obj ect> . 



WITHOUT generics 

Objects go IN as a reference to 
SoccerBall, Fish, Guitar, and 
Car objects 



took 




ArrayList 



till 

1 



And come OUT as a reference of type Object 



With generics, you can 
create type-safe collections 
where more problems are 
caught at compile-time 
instead of runtime. 

Without generics, the 
compiler would happily let 
you put a Pumpkin into an 
ArrayList that was supposed 
to hold only Cat objects. 



WITH generics 




And come out as a reference of type Fish 



540 chapter 16 



Head First Java, 2nd Edition. Head First Java, 2nd Edition, ISBN: 0596009208 

Prepared for e.simons@icarin.fiuc.org, Eduard Simons 

Copyright © 2005 Bert Bates and Kathy Sierra. This PDF is made available for personal use only during the relevant subscription term, subject to the Safari Terms of Service. Any other use 
requires prior written consent from the copyright owner. Unauthorized use, reproduction and/or distribution are strictly prohibited and violate applicable laws. All rights reserved. 







collections with generics 



learning generics 

Of the dozens of things you could learn about generics, there are 
really only three that matter to most programmers: 



(T) Creating instances of generified classes (like ArrayList) 

When you make an ArrayList, you have to tell it the type 
of objects you’ll allow in the list, just as you do with plain 
old arrays. 



new ArrayList<Song> () 



(2) Declaring and assigning variables of generic types 

How does polymorphism really work with generic 
types? If you have an ArrayList<Animal> reference 
variable, can you assign an ArrayList<Dog> to it? What 
about a List<Animal> reference? Can you assign an 
ArrayList<Animal> to it? You’ll see... 



List<Song> songList = 

new ArrayList<Song>() 



(D Declaring (and invoking) methods that take generic types 

If you have a method that takes as a parameter, say, an void f 00 (List<Song> list) 

ArrayList of Animal objects, what does that really mean? 

Can you also pass it an ArrayList of Dog objects? We’ll x . f OQ ( songList) 

look at some subtle and tricky polymorphism issues that 
are very different from the way you write methods that 
take plain old arrays. 

(This is actually the same point as # 2 , but that shows you 
how important we think it is.) 



But don't I also need to learn how to create my OWN generic 
classes? What if I want to make a class type that lets people 
instantiating the class decide the type of things that class will use? 

A- 

You probably won't do much of that. Think about it — the API 
designers made an entire library of collections classes covering most of 
the data structures you'd need, and virtually the only type of classes that 
really need to be generic are collection classes. In other words, classes 
designed to hold other elements, and you want programmers using it to 
specify what type those elements are when they declare and instantiate 
the collection class. 

Yes, it is possible that you might want to create generic classes, but that's 
the exception, so we won't cover it here. (But you'll figure it out from the 
things we do cover, anyway.) 
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generic classes 



Using generic CLASSES 

Since ArrayList is our most-used generified type, we’ll 
start by looking at its documentation. They two key areas 
to look at in a generified class are: 

1 ) The class declaration 

3 ) The method declarations that let you add elements 



Understanding ArrayList documentation 
(Or, what’s the true meaning of “E”?) 



Think of “E” as a Stand-in for 
“the type of element you want 
this collection to hold and 
return.” (E is for Element.) 



dell** tvta 



\ 




public class ArrayList<E> extends AbstractList<E> implements List<E> 



... { 



public boolean add(E o) 

A 

Here's the fart' Whatever * 

determines what kind of thiny 7 allowed 
to add to the ArrayList. 



he tyye (the value ot <6>) 
efcomes the tyye of the List 
vterfate as well- 



} 



// more code 



The “E” represents the type used to create an instance 
of ArrayList. When you see an “E” in the ArrayList 
documentation, you can do a mental find/ replace to 
exchange it for whatever <type> you use to instantiate 
ArrayList. 

So, new ArrayList<Song> means that “E” becomes “Song”, 
in any method or variable declaration that uses “E”. 
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Using type parameters with Arraylist 



collections with generics 



THIS code: 

ArrayList<String> thisList = new ArrayList<String> 




// more code 

} 

Is treated by the compiler as: 

public class ArrayList<String> extends AbstractList<String>. . . { 

public boolean add (String o) 

// more code 

} 

In other words, the “E” is replaced by the real type (also called the type parameter) 
that you use when you create the ArrayList. And that’s why the add() method 
for ArrayList won’t let you add anything except objects of a reference type that’s 
compatible with the type of “E”. So if you make an ArrayList<String>, the add() 
method suddenly becomes add(String o). If you make the ArrayList of type Dog, 
suddenly the add() method becomes add (Dog o). 




Is "E" the only thing you can put there? Because the docs for sort used "V.... 



A. 

r \ m You can use anything that's a legal Java identifier. That means anything that you 
could use for a method or variable name will work as a type parameter. But the conven- 
tion is to use a single letter (so that's what you should use), and a further convention is to 
use "T" unless you're specifically writing a collection class, where you'd use "E" to repre- 
sent the "type of the Element the collection will hold" 
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generic methods 



Using generic METHODS 



A generic class means that the class declaration includes a type 
parameter. A generic method means that the method declaration 
uses a type parameter in its signature. 

You can use type parameters in a method in several different ways: 



(?) Using a type parameter defined in the class declaration 

public class ArrayList<E> extends AbstractList<E> ... { 

public boolean add(E o) y' ** 

ft ^ us e the "F" l 

a ^dy b«„ d( f med 

When you declare a type parameter for the class, you c 

can simply use that type any place that you’d use a 

real class or interface type. The type declared in the 

method argument is essentially replaced with the type 

you use when you instantiate the class. 



(D Using a type parameter that was NOT defined in the class declaration 



public <T extends Animal> void takeThing (ArrayList<T> list) 



If the class itself doesn’t use a type parameter, you can still 
specify one for a method, by declaring it in a really unusual 
(but available) space — before the return type. This method says 
that T can be “any type of Animal”. 



« Use <Tv L 

inihe ^Zz^ 
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collections with generics 



Wait... that can't be right. If you can 
take a list of Animal, why don't you 
just SAY that? What's wrong with just 
takeThing(ArrayList< Animal > list)? 



Here's where it gets weird... 



This: 

public <T extends Animal> void takeThing (ArrayList<T> list) 

Is NOT the same as this: 

public void takeThing (ArrayList<Animal> list) 



Both are legal, but they’re different 

The first one, where <T extends Animal> is part of the method 
declaration, means that any ArrayList declared of a type that is 
Animal, or one of Animal’s subtypes (like Dog or Cat), is legal. 
So you could invoke the top method using an ArrayList<Dog>, 
ArrayList<Cat>, or ArrayList<Animal>. 



But... the one on the bottom, where the method argument is 
(ArrayList<Animal> list) means that only an ArrayList<Animal> 
is legal. In other words, while the first version takes an ArrayList 
of any type that is a type of Animal (Animal, Dog, Cat, etc.), 
the second version takes only an ArrayList of type Animal. Not 
ArrayList<Dog>, or ArrayList<Cat> but only ArrayList<Animal>. 

And yes, it does appear to violate the point of polymorphism, 
but it will become clear when we revisit this in detail at the end 
of the chapter. For now, remember that we’re only looking at 
this because we’re still trying to figure out how to sort() that 
SongList, and that led us into looking at the API for the sort() 
method, which had this strange generic type declaration. 

For now , all you need to know is that the syntax of the top version 
is legal , and that it means you can pass in a ArrayList object 
instantiated as Animal or any Animal subtype. 



And now back to our sort() method... 
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sorting a Song 



This still doesn't 
explain why the sort method 
failed on an ArrayList of Songs 
but worked for an ArrayList of 
Strings... 




Remember where we were. 



File Edit Window Help Bummer 



% j avac Jukebox3 . j ava 

Jukebox3 . java : 15 : cannot find symbol 

symbol : method sort (java. util . ArrayList<Song>) 

location: class java. util .Collections 

Collections . sort (songList) ; 



1 error 



import java. util, 
import java.io.*; 



public class Jukebox3 { 

ArrayList<Song> songList = new ArrayList<Song> () ; 

public static void main (String [ ] args) { 
new Jukebox3 ( ) . go ( ) ; 



public void go() { 
getSongs ( ) ; 

System. out .print in (songList) ; 

Collections . sort (songList) ; 

System. out .print in (songList) ; 

} 



. . .4. L^aksl \i wovked ( me 

. IS wVieve it oveaits. u- we 

ed in an MavUsUSL.n5>, Wt as 

- j L. AniravUist^on^, 't. ™ 



void getSongs () { 

try { 

File file = new File ("SongList . txt" ) ; 

But feredReader reader = new BufferedReader (new FileReader (file) ) ; 
String line = null; 

while ( (line= reader . readLine () ) != null) { 

addSong (line) ; 



} catch (Exception ex) { 
ex . printStackTrace () ; 

} 

} 

void addSong (String lineToParse) { 

String [] tokens = lineToParse . split ("/") ; 

Song nextSong = new Song (tokens [0] , tokens [1] , tokens [2], tokens [3]); 
songList . add (nextSong) ; 
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collections with generics 



Revisiting the sortO method 




So here we are, trying to read the sort() method docs to find 
out why it was OK to sort a list of Strings, but not a 
list of Song objects. And it looks like the answer is... 



Song is NOT a subtype of 
Comparable, so you cannot sort() 
the list of Songs. 



The sort() method can take only lists 
of Comparable objects. 



At least not yet... 




public static <T extends Comparable<? super T» void sort (List<T> list) 



/ 

This says 'Whatever T js must 
be of type Comparable-’ 



(Ignore this part -for now. But 
iT you dan’t, it just means 
that the type parameter for 
Comparable m usi be o( -type T 
o\r one o*P T ; s supev-types.j 



You dan pass in only a List (or 
subtype o-f list, like ArrayList) 
that uses a parameterized ty?e 
that w e%tends Comparable • 
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the sort() method 



In generics, Extends" weans 
Extends or implements" 



The Java engineers had to give you a way to put a constraint 
on a parameterized type, so that you can restrict it to, say, only 
subclasses of Animal. But you also need to constrain a type to 
allow only classes that implement a particular interface. So 
here’s a situation where we need one kind of syntax to work 
for both situations — inheritance and implementation. In other 
words, that works for both extends and implements. 

And the winning word was... extends. But it really means “is-a”, 
and works regardless of whether the type on the right is an 
interface or a class. 



In generics, the keyword 
“extends” really means “is-a”, 
and works for BOTH classes 
and interfaces. 



Comparable ,s ** ‘^‘ter-fade, so this 

reads, W T musk be a twe that 

implements the Comparable inter-fade • 

public static <T extends Comparable<? super T» void sort(List<T> list) 

T 

It doesn t matter v/hethev* tbe thing on the right is 
a dlass or inter-fade... you still say w e*tends w . 



Why didn't they just make a new keyword/'is"? 

A- 

Jr \ m Adding a new keyword to the language is a REALLY big deal because 
it risks breaking Java code you wrote in an earlier version. Think about 
it — you might be using a variable "is" (which we do use in this book to repre- 
sent input streams). And since you're not allowed to use keywords as identi- 
fiers in your code, that means any earlier code that used the keyword before 
it was a reserved word, would break. So whenever there's a chance for the 
Sun engineers to reuse an existing keyword, as they did here with "extends" 
they'll usually choose that. But sometimes they don't have a choice... 

A few (very few) new keywords have been added to the language, such 
as assert in Java 1 .4 and enum in Java 5.0 (we look at enum in the appen- 
dix). And this does break people's code, however you sometimes have the 
option of compiling and running a newer version of Java so that it behaves 
as though it were an older one. You do this by passing a special flag to the 
compiler or JVM at the command-line, that says,"Yeah, yeah, I KNOW this is 
Java 1 .4, but please pretend it's really 1 .3, because I'm using a variable in my 
code named assert that I wrote back when you guys said it would OK!#$%" 

(To see if you have a flag available, type javac (for the compiler) or java (for 
the JVM) at the command-line, without anything else after it, and you should 
see a list of available options. You'll learn more about these flags in the chap- 
ter on deployment.) 
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collections with generics 



Finally we know what's wrong... 

the Song class needs to implement Comparable 



We can pass the ArrayList<Song> to the sort() method only if the 
Song class implements Comparable, since that’s the way the sort() 
method was declared. A quick check of the API docs shows the 
Comparable interface is really simple, with only one method to 
implement: 




And the method documentation for compareTo() says 



Returns: 

a negative integer, zero, or a 
positive integer as this object 
is less than, equal to, or greater 
than the specified object. 



It looks like the compareTo() method will be called on one 
Song object, passing that Song a reference to a different 
Song. The Song running the compareTo() method has to 
figure out if the Song it was passed should be sorted higher, 
lower, or the same in the list. 

Your big job now is to decide what makes one song greater 
than another, and then implement the compareToQ method 
to reflect that. A negative number (any negative number) 
means the Song you were passed is greater than the Song 
running the method. Returning a positive number says 
that the Song running the method is greater than the Song 
passed to the compareTo() method. Returning zero means 
the Songs are equal (at least for the purpose of sorting... it 
doesn’t necessarily mean they’re the same object). You might, 
for example, have two Songs with the same title. 

(Which brings up a whole different can of worms we’ll look 
at later...) 



The big question is: what 
makes one song less than, 
equal to, or greater than 
another song? 

You can’t implement the 
Comparable interface until you 
make that decision. 
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the Comparable nterface 



The new, improved, comparable Song class 



We decided we want to sort by title, so we implement the compareTo() 
method to compare the title of the Song passed to the method against 
the title of the song on which the compareTo() method was invoked. 
In other words, the song running the method has to decide how its 
title compares to the title of the method parameter. 



Hmmm... we know that the String class must know about alphabetical 
order, because the sort() method worked on a list of Strings. We know 
String has a compareTo() method, so why not just call it? That way, we 
can simply let one title String compare itself to another, and we don’t 
have to write the comparing/ alphabetizing algorithm! 



class Song implements Comparable<Song> { 
String title; 

String artist; 

String rating; 

String bpm; 



Usually these matdh-weVe speditymg type that 
the implemen-t'mg dlass da» be dompared agamst- 

This means that W objedts dan be dompav-ed to 
other Sono, objedts, ton the purpose o+ sont.nj. 



public int compareTo (Song s) { 

return title . compareTo (s . getTitle ( ) ) ; 

} 

Song (String t, String a, String r, String b) { 
title = t; 
artist = a; 
rating = r; 
bpm = b; 

> 



The sontO method sends a Song to dompaneToO 
to see how that Song dompanes to the Song on 
whidh the method was invoked- 



■Simple! We just pass the wonk 

OY\ io -the title Stvmj objedts, 

srnde we know Strings have a 
domyaveToO method- 



public String getTitle () { 

return title; 

} 

public String getArtist() { 
return artist; 

} 

public String getRatingO { 
return rating; 

} 

public String getBpm() { 
return bpm; 

} 

public String toStringO { 
return title; 

} 

} 
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This time it worked- It prints the list, then tails sort 
whidh puts the Songs in alphabetidal onden by title- 

File Edit Window Help Ambient 



%java Jukebox3 

[Pink Moon, Somersault, Shiva Moon, Circles, Deep 
Channel, Passenger, Listen] 

[Circles, Deep Channel, Listen, Passenger, Pink 
Moon, Shiva Moon, Somersault] 
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collections with generics 



We can sort the list, but... 

There’s a new problem — Lou wants two different views of the song list, 
one by song title and one by artist! 

But when you make a collection element comparable (by having it 
implement Comparable), you get only one chance to implement the 
compareToQ method. So what can you do? 

The horrible way would be to use a flag variable in the Song class, 
and then do an if test in compareTo() and give a different result 
depending on whether the flag is set to use title or artist for the 
comparison. 

But that’s an awful and brittle solution, and there’s something much 
better. Something built into the API for just this purpose — when you 
want to sort the same thing in more than one way. 

Look at the Collections class API again. There’s a 
second sort() method — and it takes a Comparator. 



That's not good enough. 
Sometimes I want it to sort 
by artist instead of title. 



C> 

o 




Collections Gava 2 Platform SE 5.0) 



v file :/ //Users/ kalhy/ Public/ docs fapt/i ndex.htm l 



' Or Google 



:s jeHyvision. Inc. Collections .form SE 5.0] Caffeinated d Brain Day Brand Noise Diva Marketing 



» 




BipcrletonHap [ R key, V value) 

Returns an immutable map, mapping only the 
specified key to the specified value. 

sort { List <T> list) 

Sorts the specified list into ascending order, 
according to the natural ordering of its elements. 

sort [ List <T> list , ConiparatQE <? super T> c7 

the specified list according to the o jj 

ind ueed by the speeii i&u compare tor . 



(D 
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the Comparator interface 



Using a custom Comparator 

An element in a list can compare itself to another of 
its own type in only one way, using its compareTo() 
method. But a Comparator is external to the element 
type you’re comparing — it’s a separate class. So you can 
make as many of these as you like! Want to compare 
songs by artist? Make an ArtistComparator. Sort by beats 
per minute? Make a BPMComparator. 

Then all you need to do is call the overloaded sort() 
method that takes the List and the Comparator that will 
help the sort() method put things in order. 

The sort() method that takes a Comparator will use the 
Comparator instead of the element’s own compareTo() 
method, when it puts the elements in order. In other 
words, if your sort() method gets a Comparator, it won’t 
even ca^the compareTo() method of the elements 
in the list. The sort() method will instead invoke the 
compare () method on the Comparator. 

So, the rules are: 



java.util.Comparator 




If you pass a Comparator to tke 
sort() method, the sort order is 
determined by the Comparator 
rather than the element’s own 
compareTo() method. 



► Invoking the one-argument sort(List o) method 
means the list element’s compareTo() method 
determines the order. So the elements in the list 
MUST implement the Comparable interface. 



► Invoking sort(List o, Comparator c) means the 
list element’s compareTo() method will NOT be 
called, and the Comparator’s compare() method 
will be used instead. That means the elements 
in the list do NOT need to implement the 
Comparable interface. 



v; So does this mean that if you have a class that 
doesn't implement Comparable, and you don't have the 
source code, you could still put the things in order by 
creating a Comparator? 

A- 

Jr \ m That's right.The other option (if it's possible) would be 
to subclass the element and make the subclass implement 
Comparable. 




But why doesn't every class implement Comparable? 



A- 

r \ m Do you really believe that everything can be ordered? 
If you have element types that just don't lend themselves to 
any kind of natural ordering, then you'd be misleading other 
programmers if you implement Comparable. And you aren't 
taking a huge risk by not implementing Comparable, since 
a programmer can compare anything in any way that he 
chooses using his own custom Comparator. 
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collections with generics 



Updating the Jukebox to use a Comparator 

We did three new things in this code: 

1 ) Created an inner class that implements Comparator (and thus the compare() 
method that does the work previously done by compareTo ()) . 

2 ) Made an instance of the Comparator inner class. 

3 ) Called the overloaded sort() method, giving it both the song list and the 
instance of the Comparator inner class. 

Note: we also updated the Song class toString() method to print both the song 
title and the artist. (It prints title: artist regardless of how the list is sorted.) 



import java. util.*; 
import java.io.*; 



public class Jukebox5 { 

ArrayList<Song> songList = new ArrayList<Song> ( ) ; 
public static vaj^^mairW String jj args) { 
new Jukebox5 () , go() ; 

} 




Cvea-te a new i»«ev dlass -that imflen>e«L 
Compavatov (note that its type 
parameter matches the type were M 
o dompav-e— ’>* this dase Sonj objcdtsJ 



class ArtistCompare implements Comparator<Song> { 
public int compare (Song one. Song two) { 

return one . getArtist ( ) . compareTo (two . getArtist ( ) ) 



} 



} 



This bedorwes a Stv'mj (the avtist) 



public void go ( ) { 

getSongs ( ) ; 

System. out .print in (songList) ; 
Collections . sort (songList) ; 
System. out .print in (songList) ; 



dio tk aetual S ^' M9 va,riables ( tor artist) 

U •*» L ahread y 



Make an instande o-f the 
Comyav-atov innev- dlass. 



ArtistCompare artistCompare = new ArtistCompare () 

Collections . sort (songList , artistCompare) ; 

torn objedt. 



System. out .print in (songList) , 



void getSongs () { 

// I/O code here 

} 

void addSong (String lineToParse) { 

// parse line and add to song list 

} 



Note: we've made sort-by-title the default sort, by 
keeping the compareToO method in Song use the 
titles. But another way to design this would be to 
implement both the title sorting and artist sorting as 
inner Comparator classes, and not have Song implement 
Comparable at all. That means we'd always use the two- 
arg version of Collections. sortQ. 
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collections exercise 



import ; 

public class SortMountains { 

LinkedList mtn = new LinkedList ( ) ; 




class NameCompare { 

public int compare (Mountain one. Mountain two) { 

return ; 

} 

} 

class HeightCompare { 

public int compare (Mountain one. Mountain two) { 

return ( ) ; 

} 

} 

public static void main (String [] args ) { 
new SortMountain ( ) . go ( ) ; 

} 

public void go( ) { 

mtn. add (new Mountain ( "Longs" , 14255)); 
mtn. add (new Mountain ( "Elbert" , 14433)); 
mtn. add (new Mountain ( "Maroon" , 14156)); 
mtn.add(new Mountain ( "Castle" , 14265)); 

System. out .println( "as entered: \n" + mtn); 

NameCompare nc = new NameCompare ( ) ; 



Reverse Engineer 

Assume this code exists in 
a Single file. Your job is 
to fill in the blanks So the 
die program will create the 
output shown. 



Note: answers are at the end of 
the chapter. 



System. out .println( "by name:\n" + mtn); 
HeightCompare he = new HeightCompare () ; 



System. out .println( "by height: \n" + mtn); 

} 

} 

class Mountain { 



r ! 

F 


Output: 




| File Edit Window Help ThisOne’sForBob 


{ 


%java SortMountains 




as entered: 


/ 


[Longs 14255, Elbert 14433, Maroon 14156, Castle 14265] 


r 

} 


by name: 


{ 


[Castle 14265, Elbert 14433, Longs 14255, Maroon 14156] 




by height: 


} 


[Elbert 14433, Castle 14265, Longs 14255, Maroon 14156] 
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collections with generics 



^enywrpmil 

For each of the questions below, fill in the blank 
with one of the words from the "possible answers" 
list, to correctly answer the question. Answers are 
at the end of the chapter. 

Possible Answers: 

Comparator, 

Comparable, 
compareTo( ), 
compare( ), 
yes, 
no 

Given the following compilable statement: 

Collections . sort (myArrayList) ; 

1. What must the class of the objects stored in myArrayList implement? 

2. What method must the class of the objects stored in myArrayList implement? 

3. Can the class of the objects stored in myArrayList implement both 
Comparator AND Comparable? 



Given the following compilable statement: 

Collections . sort (myArrayList , myCompare) ; 

4. Can the class of the objects stored in myArrayList implement Comparable? 

5. Can the class of the objects stored in myArrayList implement Comparator? 

6. Must the class of the objects stored in myArrayList implement Comparable? 

7. Must the class of the objects stored in myArrayList implement Comparator? 

8. What must the class of the myCompare object implement? 

9. What method must the class of the myCompare object implement? 
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dealing with duplicates 



Uh-oh. The sorting all works, but now we have duplicates... 

The sorting works great, now we know how to sort on both title (using the Song object’s 
compareTo() method) and artist (using the Comparator’s compare () method). But there’s 
a new problem we didn’t notice with a test sample of the jukebox text hie — the sorted list 
contains duplicates. 

It appears that the diner jukebox just keeps writing to the hie regardless of whether the 
same song has already been played (and thus written) to the text hie. The SongListMore.txt 
jukebox text hie is a complete record of every song that was played, and might contain the 
same song multiple times. 



I File Edit Window Help TooManyNotes 




%java Jukebox4 




[Pink Moon: Nick Drake, Somersault: Zero 7, Shiva Moon: Prem 
Joshua, Circles: BT, Deep Channel: Afro Celts, Passenger: 
Headmix, Listen: Tahiti 80, Listen: Tahiti 80, Listen: Tahiti 
80, Circles: BT] 


-Behove sovWy 


[Circles: BT, Circles: BT, Deep Channel: Afro Celts, Listen: 
Tahiti 80, Listen: Tahiti 80, Listen: Tahiti 80, Passenger: 
Headmix, Pink Moon: Nick Drake, Shiva Moon: Prem Joshua, 
Somersault: Zero 7] 


ftflcr sovtm^ ^‘>*5 
'the ovm 

domyaveToO method 
(sort by title)- 


[Deep Channel: Afro Celts, Circles: BT, Circles: BT, Passenger: 
Headmix, Pink Moon: Nick Drake, Shiva Moon: Prem Joshua, Listen: 
Tahiti 80, Listen: Tahiti 80, Listen: Tahiti 80, Somersault: 

Zero 7] 


/Vftev sovtm^ 

the Avt»stCo- ? ajre 

Comyav-atov (sort by 

av-tist *ame)- 



SongListMore . txt 



Pink Moon/Nick Drake/5/80 
Somersault/Zero 7/4/84 
Shiva Moon/Prem Joshua/6/120 
Circles/BT/5/110 
Deep Channel/Afro Celts/4/120 
Passenger/Headmix/ 4/100 
Listen/Tahiti 80/5/90 
Listen/Tahiti 80/5/90 
Listen/Tahiti 80/5/90 
Circles/BT/5/110 






'V; 0 
& 



K 1 *™ h fjr ■■ 
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collections with generics 



We need a Set instead of a list 

From the Collection API, we find three main interfaces, List, Set, and 
Map. ArrayList is a List, but it looks like Set is exactly what we need. 



► LIST ■ when sequence matters 

Collections that know about index position. 

Lists know where something is in the list. You 
can have more than one element referencing 
the same object. 



> SET ■ when uniqueness matters 
Collections that do not aiiow duplicates. 

Sets know whether something is already in the collection. 
You can never have more than one element referencing 
the same object (or more than one element referencing 
two objects that are considered equal— we’ll look at what 
object equality means in a moment). 




Set 



>► MAP - when finding something by key matters 

Collections that use key-value pairs. 

Maps know the value associated with a given key. You 
can have two keys that reference the same value, but you 
cannot have duplicate keys. Although keys are typically 
String names (so that you can make name/value property 
lists, for example), a key can be any object. 







Map 
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the collections API 



The Collection API (part of it) 



Notice that the Map interface doesn’t 
actually extend the Collection interface, 
but Map is still considered part of the 
“Collection Framework” (also known 
as the “Collection API”). So Maps are 
still collections, even though they don’t 
include java. util. Collection in their 
inheritance tree. 



Collection 

(interface) 



(Note: this is not the complete 
collection API; there are other 
classes and interfaces, but 
these are the ones we care 
most about.) 



/ 



\ 



Set 




List 


(interface) 




(interface) 






SortedSet 

(interface) 



TreeSet 



LinkedHashSet 



HashSet 



ArrayList 



LinkedList 



Vector 







Mays <Wt -from 

\ava.util.Collefction, bu-t 
tbcyVc still donsidev-ed 
i o be yart o( the 

w dolledt»or>s Wdvntwo'cV! 

m Java. So a May is 
still v-e-fev-v-ed -to as a 
dolled-bio*. 



Hashtable 
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collections with generics 



Using a HashSet instead of Arraylist 

We added on to the Jukebox to put the songs in a HashSet. (Note: we left out some 
of the Jukebox code, but you can copy it from earlier versions. And to make it easier 
to read the output, we went back to the earlier version of the Song’s toString() 
method, so that it prints only the title instead of title and artist.) 



import java. util.*; 
import java.io.*; 



public class Jukebox6 { 

ArrayList<Song> songList = new ArrayList<Song> ( ) ; <^_ 
// main method etc. 



. We didn't tKa« 9 e getSongsO, so it still p»ts the so»gs m an AwayUst 



He vc we Create a new HashSet 

yavaw»eteviiedi to hold Son^s. 



public void go ( ) { 

getSongs () ; ^ 

System. out .println (songList) ; 

Collections . sort (songList) ; 

System. out .println (songList) ; v 

HashSet<Song> songSet = new HashSet<Song> () ; 

songs. t.addAll (songList) ; ^ ^ , 

Sys t.m . out . pcin t In ( songs, t ) ; «« L 

’ smL f ’ tk ,' “ tid'd sjjI, 

// getSongs () and addSongO methods much sirwplev-1 



File Edit Window Help GetBetterMusic 



%java Jukebox 6 

[Pink Moon, Somersault, Shiva Moon, Circles, Deep Channel, 
Passenger, Listen, Listen, Listen, Circles] 

[Circles, Circles, Deep Channel, Listen, Listen, Listen, 
Passenger, Pink Moon, Shiva Moon, Somersault] 

[Pink Moon, Listen, Shiva Moon, Circles, Listen, Deep Channel, 
Passenger, Circles, Listen, Somersault] 



The £e*t didh ; *fc help// 

We s-foll have all -the duplicates/ 



(A»d \i lost its sort order 
whe* we put the list mto a 
HashSet, but we II worry about 



- Betove sov£ih<j 

the Av-rayList 



.. A-ftev sortw$ 
tbe A^vayUst 
(by title)- 

A-ftev putting »t 
mto a HashSet, 
and pvmtm^ tbe 
HashSet (we did* t 
dall sortO a^a'm). 



that ov \t latev-.. ) 
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object equality 



What makes two objects equal? 

First, we have to ask — what makes two Song references 
duplicates? They must be considered equal. Is it simply two 
references to the very same object, or is it two separate objects 
that both have the same title ? 

This brings up a key issue: reference equality vs. object equality. 



y Reference equality 

Two references, one object on the heap. 

Two references that refer to the same object on 
the heap are equal. Period. If you call the hashCode() method on 
both references, you’ll get the same result. If you don’t override the 
hashCode() method, the default behavior (remember, you inherited 
this from class Object) is that each object will get a unique number 
(most versions of Java assign a hashcode based on the object’s 
memory address on the heap, so no two objects will have the same 
hashcode). 

If you want to know if two references are really referring to the same 
object, use the == operator, which (remember) compares the bits in 
the variables. If both references point to the same object, the bits will 
be identical. 



If two objects foo and bar are 
equal, foo.equals(bar) must be 
true, and both foo and bar must 
return the same value from 
hashCodef). For a Set to treat 
two objects as duplicates, you 
must override the hashCode() 
and equals() methods inherited 
from class Object, so that you 
can make two different objects 
be viewed as equal. 




Song 

if (foo == bar) { 



// both references are referring 
//to the same object on the heap 



y Object equality 

Two references, two objects on the heap, but 
the objects are considered meaningfully equivalent. 

If you want to treat two different Song objects as equal (for 
example if you decided that two Songs are the same if they have 
matching title variables), you must override both the hashCode() 
and equals() methods inherited from class Object. 

As we said above, if you don’t override hashCode(), the default 
behavior (from Object) is to give each object a unique hashcode 
value. So you must override hashCode() to be sure that two 
equivalent objects return the same hashcode. But you must also 
override equals() so that if you call it on either object, passing in 
the other object, always returns true. 

if ( foo. equals (bar) 




Song 



&& foo. hashCode ( ) == bar . hashCode () ) { 



// 

// 



both references are referring to either a 
a single object, or to two objects that are equal 



} 
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collections with generics 



How a HashSet checks for duplicates: hashCodeO and equals! ) 



When you put an object into a Hashset, it uses the 
object’s hashcode value to determine where to put 
the object in the Set. But it also compares the object’s 
hashcode to the hashcode of all the other objects in 
the HashSet, and if there’s no matching hashcode, 
the HashSet assumes that this new object is not a 
duplicate. 

In other words, if the hashcodes are different, the 
HashSet assumes there’s no way the objects can be 
equal! 

So you must override hashCode () to make sure the 
objects have the same value. 

But two objects with the same hashCode () might not 



HashSet finds a matching hashcode for two objects — 
one you’re inserting and one already in the set — the 
HashSet will then call one of the object’s equals () 
methods to see if these hashcode-matched objects 
really are equal. 

And if they’re equal, the HashSet knows that the 
object you’re attempting to add is a duplicate of 
something in the Set, so the add doesn’t happen. 

You don’t get an exception, but the HashSet’s add() 
method returns a boolean to tell you (if you care) 
whether the new object was added. So if the add() 
method returns false, you know the new object was a 
duplicate of something already in the set. 



be equal (more on thi s on the next page), so if the 




Objedt you’re trying 
to add run s its e«\«aUO 
title: Circles \ w.etbod> dompav'mj itsel-f 
hashCode: 742 ) to bav, and returns t rue- 



. Obiedt already IN 

title: Circles \ ^ tfashSet- 

hashCode: 742 
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overriding hashCode() and equals() 



The Song class with overridden 
hashCodeO and equals!) 



class Song implements Comparable<Song>{ 
String title; 

String artist; 

String rating; 

String bpm; 






TYie ^ 

„ e tV,od) >t 



e \se 



{ 



public boolean equals (Object aSong) 

Song s = (Song) aSong; 

return getTi tie ( ) . equals ( s . getTi tie ( ) ) 

} 



^AT «e*s i* * a 



public int hashCode ( ) { 



deal here *, Fh^ cJ-l.* i 

return title .hashCode () ^ hashCodeO Kcihod v lh 9 Cla “ , as overridden 
} calling hashCodeO on thttiUe f he <resul ^ 

«V*0 are usi^st^ h °" ^od e 0 

public int compareTo (Song s) { 3 ^ '^stahde variable- 

return title . compareTo ( s . getTi tie ( ) ) ; 



Song (String t, String a, String r, String b) { 
title = t; 

artist = a; Now j-fc works/ No duplicates when we 

rating = r; print out the ttash&t But we didn't 

b P m = b; ^all sov-tO agai^ and when we put 

} the Arv-ayList into the ttashSet, the 

ttashSet didn ; t preserve the sort order. 

public String getTitle ( ) { 



return title; 

} 



public String getArtist ( ) 
return artist; 

} 



public String getRating ( ) 
return rating; 

} 



public String getBpm() { 
return bpm; 

} 



public String toStringO { 
return title; 

} 



File Edit Window Help RebootWindows 



%java Jukebox 6 

[Pink Moon, Somersault, Shiva Moon, Circles, 
Deep Channel, Passenger, Listen, Listen, 
Listen, Circles] 

[Circles, Circles, Deep Channel, Listen, 
Listen, Listen, Passenger, Pink Moon, Shiva 
Moon, Somersault] 



[Pink Moon, Listen, Shiva Moon, Circles, 
J Deep Channel, Passenger, Somersault] 
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collections with generics 



Java Object Law For HashCode() 
and equals() 



The API docs for class Object state the 
rules you MUST follow: 

^ If two objects are equal, they MUST 
have matching hashcodes. 



^ If two objects are equal, calling 
equals() on either object MUST return 
true. In other words, if (a.equals(b)) then 
(b.equals(a)). 

^ If two objects have the same hashcode 
value, they are NOT required to be equal. 
But if they’re equal, they MUST have the 
same hashcode value. 



So, if you override equals(), you MUST 
override hashCode(). 

^ The default behavior of hashCode() 
is to generate a unique integer for each 
object on the heap. So if you don’t override 
hashCode() in a class, no two objects of 
that type can EVER be considered equal. 

^ The default behavior of equals() is to 
do an == comparison. In other words, to 
test whether the two references refer to a 
single object on the heap. So if you don’t 
override equals() in a class, no two objects 
can EVER be considered equal since 
references to two different objects will 
always contain a different bit pattern. 

a.equals(b) must also mean that 
a.hashCodef) == b.hashCodef) 

But a.hashCode() == b.hashCodef) 
does NOT have to mean a.equals(b) 



tiunilT^uestions 

% How come hashcodes can be the same 
even if objects aren't equal? 

A- 

Jr \* HashSets use hashcodes to store the ele- 
ments in a way that makes it much faster to access. 
If you try to find an object in an ArrayList by giving 
the ArrayList a copy of the object (as opposed to 
an index value), the ArrayList has to start searching 
from the beginning, looking at each element in 
the list to see if it matches. But a HashSet can find 
an object much more quickly, because it uses the 
hashcode as a kind of label on the "bucket" where 
it stored the element. So if you say,"l want you 
to find an object in the set that's exactly like this 
one..."the HashSet gets the hashcode value from 
the copy of the Song you give it (say, 742), and 
then the HashSet says, "Oh, I know exactly where 
the object with hashcode #742 is stored..." and it 
goes right to the #742 bucket. 

This isn't the whole story you get in a computer 
science class, but it's enough for you to use Hash- 
Sets effectively. In reality, developing a good hash- 
code algorithm is the subject of many a PhD thesis, 
and more than we want to cover in this book. 

The point is that hashcodes can be the same 
without necessarily guaranteeing that the objects 
are equal, because the"hashing algorithm" used in 
the hashCodeO method might happen to return 
the same value for multiple objects. And yes, that 
means that multiple objects would all land in the 
same bucket in the HashSet (because each bucket 
represents a single hashcode value), but that's not 
the end of the world. It might mean that the Hash- 
Set is just a little less efficient (or that it's filled 
with an extremely large number of elements), but 
if the HashSet finds more than one object in the 
same hashcode bucket, the HashSet will simply 
use the equalsO method to see if there's a perfect 
match. In other words, hashcode values are some- 
times used to narrow down the search, but to find 
the one exact match, the HashSet still has to take 
all the objects in that one bucket (the bucket for 
all objects with the same hashcode) and then call 
equalsO on them to see if the object it's looking for 
is in that bucket. 
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TreeSets and sorting 



And if we want the set to stay 
sorted, weVe got TreeSet 

TreeSet is similar to HashSet in that it prevents duplicates. But it also keeps the list sorted. It works 
just like the sort() method in that if you make a TreeSet using the set’s no-arg constructor, the 
TreeSet uses each object’s compareTo() method for the sort. But you have the option of passing 
a Comparator to the TreeSet constructor, to have the TreeSet use that instead. The downside to 
TreeSet is that if you don’t need sorting, you’re still paying for it with a small performance hit. But 
you’ll probably find that the hit is almost impossible to notice for most apps. 

import java. util.*; 
import java.io.*; 
public class Jukebox8 { 

ArrayList<Song> songList = new ArrayList<Song> ( ) ; 
int val; 



public static void main (String [ ] args) { 
new Jukebox8 ( ) . go ( ) ; 



public void go ( ) { 

getSongs ( ) ; 

System. out .print in (songList) ; 
Collections . sort (songList) ; 
System. out .println (songList) ; 

TreeSet<Song> songSet = new 
songSet . addAll (songList) ; 

System. out .println (songSet) ; 



void getSongs () { 

try { 



TreeSet<Song> () ; 



I a T ^ ee c£t ^ 

, f wse tfce Sor-5 obyAs 

„,ea»s tV* t d jf*. -the sort- 

to^aveToO „ ava W 

Mt to M to* ? asse<1 m ? 



Wc dah add all the souqs fVor* the ttash^t 

■*» ■f J o,«v «, Lu JrJs 

^Mlhr wms ««5SetaddO jwt 
the way we added so^s to the /WayList J 



File file = new File ("SongListMore . txt" ) ; 

But feredReader reader = new BufferedReader (new FileReader (file) ) ; 
String line = null; 

while ( (line= reader . readLine () ) != null) { 

addSong (line) ; 

} 



} catch (Exception ex) { 
ex.printStackTrace () ; 

} 



void addSong (String lineToParse) { 

String [] tokens = lineToParse . split ("/") ; 

Song nextSong = new Song (tokens [ 0 ] , tokens [1], tokens [2], tokens [3]); 
songList . add (nextSong) ; 
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collections with generics 



What you MUST know about TreeSet... 

TreeSet looks easy, but make sure you really understand what you need to 
do to use it. We thought it was so important that we made it an exercise so 
you’d have to think about it. Do NOT turn the page until you’ve done this. 
We mean it. 




Look at this code. 
Read it carefully, then 
answer the questions 
below. (Note: there 
are no syntax errors 
in this code.) 



import j ava . util . * ; 



public class TestTree { 

public static void main (String [] args) { 
new TestTree () .go() ; 

} 

public void go() { 

Book bl = new Book ("How Cats Work") ; 
Book b2 = new Book ("Remix your Body") ; 
Book b3 = new Book ("Finding Emo") ; 



TreeSet<Book> tree = new TreeSet<Book> ( ) ; 
tree.add(bl) ; 
tree. add (b2) ; 
tree. add (b3) ; 

System. out .print In (tree) ; 

} 

} 



class Book { 

String titled- 
public Book (String t) { 
title = t; 

} 

} 



1).What is the result when you compile this code? 



2). If it compiles, what is the result when you run the TestTree class? 



3). If there is a problem (either compile-time or runtime) with this code, how would you fix it? 
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how TreeSets sort 



TreeSet elements MUST be comparable 

TreeSet can’t read the programmer’s mind to figure out how the 
object’s should be sorted. You have to tell the TreeSet how. 



To use a TreeSet, one of these 
things must be true: 



^ The elements in 

the list must be of a type that 
implements Comparable 



The Book Class on the previous class Book implements Comparable { 

page didn’t implement Comparable, so it string title; 



wouldn’t work at runtime. Think about it, the 
poor TreeSet’s sole purpose in life is to keep 
your elements sorted, and once again— it had 
no idea how to sort Book objects! It doesn’t fail 
at compile-time, because the TreeSet add() 
method doesn’t take a Comparable type, The 
TreeSet add() method takes whatever type 
you used when you created the TreeSet. In 
other words, if you say new TreeSet<Book>() 
the add() method is essentially add(Book). And 
there’s no requirement that the Book class 
implement Comparable! But it fails at runtime 
when you add the second element to the set. 
That’s the first time the set tries to call one of 
the object’s compareTo() methods and... can’t. 



public Book (String t) { 
title = t; 

} 

public int compareTo (Ob ject b) { 

Book book = (Book) b; 

return (title . compareTo (book . title) ) ; 

} 



OR 

^ You use the TreeSet’s 
overloaded constructor 
that takes a Comparator 



public class BookCompare implements Comparator<Book> { 
public int compare (Book one. Book two) { 
return (one . title . compareTo (two . title) ) ; 



TreeSet works a lot like the sort() 
method— you have a choice of using the 
element’s compareTo() method, assuming 
the element type implemented the 
Comparable interface, OR you can use 
a custom Comparator that knows how 
to sort the elements in the set. To use a 
custom Comparator, you call the TreeSet 
constructor that takes a Comparator. 



class Test { 

public void go() { 

Book bl = new Book ("How Cats Work"); 

Book b2 = new Book ("Remix your Body"); 

Book b3 = new Book ("Finding Emo") ; 

BookCompare bCompare = new BookCompare ( ) ; 
TreeSet<Book> tree = new TreeSet<Book> (bCompare) ; 

tree. add (new Book ("How Cats Work") ; 
tree. add (new Book ("Finding Emo"); 
tree.add(new Book("Remix your Body"); 

System. out .print In (tree) ; 
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collections with generics 



We've seen lists and Sets, mow we'll use a Map 

Lists and Sets are great, but sometimes a Map is the best collection (not Collection 
with a capital “C” — remember that Maps are part of Java collections but they don’t 
implement the Collection interface) . 

Imagine you want a collection that acts like a property list, where you give it a name 
and it gives you back the value associated with that name. Although keys will often be 
Strings, they can be any Java object (or, through autoboxing, a primitive). 




Map 



Each element in a Map is actually 
TWO objects — a key and a value. 
You can have duplicate values, but 
NOT duplicate keys. 



Map example 

import java. util.*; 

TWO t y?( ? 

public class TestMap { ° hC +ov " the key a*d one -Pov -fche value, 

public static void main (String [ ] args) { 

HsshMsp^ S tlT 1 It CJ f scorss n@w HashMap<String, Integer>() ; 




} 



scores . 
scores . 
scores . 



put ("Kathy", 
put ("Bert", 
put ("Skyler" 




■ V UINCa 






r '•Key, 






System. out .print in (scores) 
System. out .print in (scores . 



get ("Bert") ) ; -t-l « 

The ge-tO method takes a key, a*d 

r * W value ^ -this t*i, a n hiepr). 



File Edit Window Help WhereAml 



%java TestMap 

{Skyler=420, Bert=343, Kathy=42} 
343 



yoU , F V hi \**f> * 3 ives you the key=value, 
m kates { } instead o-f the bvaekeis f J you 
' wheh lists and sets 



see 



you are here ► 567 



Head First Java, 2nd Edition. Head First Java, 2nd Edition, ISBN: 0596009208 

Prepared for e.simons@icarin.fiuc.org, Eduard Simons 

Copyright © 2005 Bert Bates and Kathy Sierra. This PDF is made available for personal use only during the relevant subscription term, subject to the Safari Terms of Service. Any other use 
requires prior written consent from the copyright owner. Unauthorized use, reproduction and/or distribution are strictly prohibited and violate applicable laws. All rights reserved. 










generic types 



Finally back to generics 

Remember earlier in the chapter we talked about how methods 
that take arguments with generic types can be... weird. And we 
mean weird in the polymorphic sense. If things start to feel 
strange here, just keep going — it takes a few pages to really tell 
the whole story. 

We’ll start with a reminder on how array arguments work, 
polymorphically, and then look at doing the same thing with 
generic lists. The code below compiles and runs without errors: 

Here’s how it works with regular arrays : 

import java. util.*; 



If a method argument is an array 
of Animals, it will also take an 
array of any Animal subtype. 

In other words, if a method is 
declared as: 

void foo(Animal[] a) {} 

Assuming Dog extends Animal, 
you are free to call both: 

foo(an Animal Array); 
foo(aDogArray); 



public class TestGenericsl { 

public static void main (String [ ] args) { 
new TestGenericsl (). go () ; 

} ireaie an Animal an-ay, 

si holds b °th dogs and tab- 7 

public void go() { 

Animal [] animals = {new Dog() , new Cat() , new Dog()}; 

Dog [ ] dogs = { new Dog ( ) , new Dog ( ) , new Dog ( ) } ; 

takeAnimals (animals) ; Dedave and dv-eate a Dog arv-ay, 

takeAnimals (dogs) ; ■fcake/Wiw»alsO, using bo-fch that holds only Dogs (the dor*pile\r 

} ^ ' array types as argurhents... won t let you put a Cat in). 



public void takeAnimals (Animal [ ] animals) { 



for (Animal 
a.eat() ; 



a: animals) { 



ttT; V" a ",° NLV tt ' » tm 

animal, smde the an^a s Ji... a . , 



Th k J a y ?"? i is f hai the ^akeAhimaW) 

Animate ov a DooCl 
^°9 IS-A Animal. Polymorphism in atiion. 



sinde 



animals parameter is of iy ?e A^Varr'ay, 



a»d we didn't do an y easting. ftVhaC would we east it to? 
That ay-ray might hold both Dogs and Cats.) 



abstract class Animal { 
void eat() { 

System. out .pr in tin ("animal eating") ; 



} 

} 

class Dog extends Animal { 
void bark ( ) { } 

} 

class Cat extends Animal { 
void meow() { } 

} 



The simplified Animal elass hierarchy 
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collections with generics 



Using polymorphic arguments and generics 

So we saw how the whole thing worked with arrays, but will it work 
the same way when we switch from an array to an ArrayList? Sounds 
reasonable, doesn’t it? 

First, let’s try it with only the Animal ArrayList. We made just a few 
changes to the go() method: 



Passing in just ArrayList<Animal> 



public void go ( ) { 



A simple change bo* A»i*al£J to 
/WayList<Ani*al>. 



ArrayList<Animal> animals 

animals . add (new Dog ( ) ) ; 
animals . add (new Cat()); ^ — 

animals . add (new Dog ( ) ) ; 

takeAnimals (animals) ; < 



= new ArrayList<Animal> () 



rs ho 



1' +71 t0 7 d M* 3i a ^ S>n£e Neve's 
sh ° M ****** like W is U atrray creaW 

th V a ’" e / ode, r £epi hOW "animals" 

variable refer, to an A^ayLisl i ..bad of array. 



public void takeAnimals (ArrayList<Animal> animals) 

for (Animal a: animals) { 



a . eat ( ) ; 



The method now fakes an ArrayList 
instead of an array, but everything else is 
the same. Remember, that for loop syntax 
Works for both arrays and Collections. 



Compiles and runs just fine 



File Edit Window Help CatFoodlsBetter 



%java TestGenerics2 

animal eating 
animal eating 
animal eating 
animal eating 
animal eating 
animal eating 
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polymorphism and generics 



Put will it work with Arrayli$t<l?og> ? 

Because of polymorphism, the compiler let us pass a Dog array 
to a method with an Animal array argument. No problem. And 
an ArrayList<Animal> can be passed to a method with an 
ArrayList<Animal> argument. So the big question is, will the 
ArrayList<Animal> argument accept an ArrayList<Dog>? If it works 
with arrays, shouldn’t it work here too? 

Passing in just ArrayList<Dog> 



public void go() { 

ArrayList<Animal> animals 
animals . add (new Dog()); 
animals . add (new Cat()); 
animals . add (new DogO); 
takeAnimals (animals) ; 



new ArrayList<Animal> ( ) 



We khow -this lihc worked -Pi 



me- 



ArrayList<Dog> dogs = new ArrayList<Dog> () ; 

dogs, add (new DogO); a t) a 

dogs . add (new Dog ( ) ) ; ,s ^ P u "^ a ^ ou ple dogs m 

takeAnimals (dogs) ; «_ „ tk „ ^ ^ w 

+<ronr, an array io an firrayLisi? 



public void takeAnimals (ArrayList<Animal> animals) { 

for (Animal a: animals) { 
a . eat ( ) ; 

} 

} 



When we compile it: 



File Edit Window Help CatsAreSmarter 



%java TestGenerics3 

TestGenerics3 . java: 21 : takeAnimals (java. util . 
ArrayList<Animal>) in TestGenerics3 cannot be applied to 
( java. util . ArrayList<Dog>) 
takeAnimals (dogs) ; 

A 

1 error 



li looked so right, 
but went so wrong... 
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collections with generics 




And I'm supposed to be OK with this? That 
totally screws my animal simulation where the 
veterinary program takes a list of any type of 
animal, so that a dog kennel can send a list of dogs, 
and a cat kennel can send a list of cats... now 
you're saying I can't do that if I use collections 
instead of arrays? 



What could happen if it were allowed... 

Imagine the compiler let you get away with that. It let you pass an 
ArrayList<Dog> to a method declared as: 

public void takeAnimals (Array Li st<Animal> animals) 
for (Animal a: animals) { 
a . eat ( ) ; 



There’s nothing in that method that looks harmful, right? After all, 
the whole point of polymorphism is that anything an Animal can 
do (in this case, the eat() method), a Dog can do as well. So what’s 
the problem with having the method call eat() on each of the Dog 
references? 



Nothing. Nothing at all. 

There’s nothing wrong with that code. But imagine this code instead: 



public void takeAnimals (ArxayList<Animal> animals) { 

, animals, add (new Cat () ) y^,, We ^ sWk a ^ ^ 

r*ijlvt be a Po^s-ohly Av-v-ayList. 

So that’s the problem. There’s certainly nothing wrong with adding a 
Cat to an ArrayList<Animal>, and that’s the whole point of having an 
ArrayList of a supertype like Animal — so that you can put all types of 
animals in a single Animal ArrayList. 

But if you passed a Dog ArrayList — one meant to hold ONLY Dogs — 
to this method that takes an Animal ArrayList, then suddenly you’d 
end up with a Cat in the Dog list. The compiler knows that if it lets 
you pass a Dog ArrayList into the method like that, someone could, 
at runtime, add a Cat to your Dog list. So instead, the compiler just 
won’t let you take the risk. 

If you declare a method to take ArrayList<Animal> it can take ONLY an 
Array List<Animal>, not ArrayList<Dog> or Array List<Cat>. 
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arrays vs. ArrayLists 



Wait a minute... if this is why they won't let 
you pass a Dog ArrayList into a method that 
takes an Animal ArrayList— to stop you from 
possibly putting a Cat in what was actually a Dog list, 
then why does it work with arrays ? Don't you have 
the same problem with arrays? Can't you still add 
a Cat object to a Dog[] ? 



Array types are checked again at 
run tim e, but collection type checks 
happen only when you compile 



Let’s say you do add a Cat to an array declared as Dog[] (an array that 
was passed into a method argument declared as Animal [] , which is a 
perfectly legal assignment for arrays) . 

public void go() { 

Dog [ ] dogs = { new Dog ( ) , new Dog ( ) , new Dog ( ) } ; 
takeAnimals (dogs) ; 

} 



public void takeAnimals (Animal [ ] animals) { 
animals [0] = new Cat(); 

} We pu-t 5 *ew 3 an-ay. The 

Compiler allowed i*t, because it knows that 
you mijht have passed a Cat array or Animal 
array to the method, so to the Compiler it 
was possible that this w as 0 \ s. 



It compiles, but when we run it: 



Whew/ /\-t leas-fe -the 
Jl/M stopped it. 



|TiiT*Edir^vindow**Heip*TatsAreSmart^ 



%java TestGenericsl 
Exception in thread "main" java. 

Cat 

at TestGenericsl . takeAnimals (TestGenericsl . java : 16) 
at TestGenericsl .go (TestGenericsl . java: 12) 
at TestGenericsl .main (TestGenericsl . java: 5) 
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collections with generics 




Wouldn't it be dreamy if there were 
a way to still use polymorphic collection 
types as method arguments, so that my 
veterinary program could take Dog lists 
and Cat lists? That way I could loop through 
the lists and call their immunize() method, 
but it would still have to be safe so that you 
couldn't add a Cat in to the Dog list. But I 
guess that's just a fantasy... 
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generic wildcards 



Wildcards to the rescue 



It looks unusual, but there is a way to create a method argument that 
can accept an ArrayList of any Animal subtype. The simplest way is to 
use a wildcard — added to the Java language explicitly for this reason. 



public void takeAnimais (ArrayList<? extends Animal> 

for (Animal a: animals) { 
a . eat ( ) ; 

} 

} 




So now you’re wondering, “What’s the difference ? Don’t you have 
the same problem as before? The method above isn’t doing 
anything dangerous — calling a method any Animal subtype is 
guaranteed to have — but can’t someone still change this to add a 
Cat to the animals list, even though it’s really an ArrayList<Dog>? 
And since it’s not checked again at runtime, how is this any 
different from declaring it without the wildcard?” 



animals) { 

Remember, -the keyword ''extends” 
here means either extends OR 
implements depending on the 
type. So i-f you want to take 
an ArrayList o-f types that 
implement the Pet inter-fade, 
you d dedlare it as: 

ArrayList<? extends Pet> 



And you’d be right for wondering. The answer is NO. When you 
use the wildcard <?> in your declaration, the compiler won’t let 
you do anything that adds to the list! 



When you use a wildcard in your method 
argument, the compiler will STOP you from doing 
anything that could hurt the list referenced by the 
method parameter. 

You can still invoke methods on the elements in 
the list, but you cannot add elements to the list. 

In other words, you can do things with the list 
elements, but you can’t put new things in the list. 
So you’re safe at runtime, because the compiler 
won’t let you do anything that might be horrible at 
runtime. 

So, this is OK inside takeAnimals(): 

for (Animal a: animals) { 
a . eat ( ) ; 

} 

But THIS would not compile: 

animals . add (new Cat()); 
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collections with generics 



Alternate syntax for doing the same thing 

You probably remember that when we looked at the sort() method, 
it used a generic type, but with an unusual format where the type 
parameter was declared before the return type. It’s just a different way 
of declaring the type parameter, but the results are the same: 



This: 

public <T extends Animal> void takeThing (ArrayList<T> list) 



Does the same thing as this: 

public void takeThing (ArrayList<? extends Animal> list) 



fkreiareno 0 

Dumb Questions 

% If they both do the same thing, why would you use 
one over the other? 

A- 

It all depends on whether you want to use "T" some- 
where else. For example, what if you want the method to 
have two arguments — both of which are lists of a type that 
extend Animal? In that case, it's more efficient to just declare 
the type parameter once: 

public <T extends Animal> void takeThing (ArrayList<T> one, ArrayList<T> two) 

Instead of typing: 

public void takeThing (ArrayList<? extends Animal> one, 

ArrayList<? extends Animal> two) 
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be the compiler exercise 




BE ffce compiler, advanced 



Your job is to play compiler and determine which of 
e statements would compile. But some of this 
2 wasn't covered in the chapter, so you need to 
< out the answers based on what you DID learn, 
applying the "rules" to these new situations. In 
some cases, you might have to guess, but the 
point is to come up with a reasonable answer 
based on what you know so far. 

(Note: assume that this code is within a legal class and 
method.) 




Compiles? 



□ ArrayList<Dog> dogsl = new ArrayList<Animal> () ; 



□ ArrayList<Animal> animalsl = new ArrayList<Dog> () ; 



□ List<Animal> list = new ArrayList<Animal> () ; 



□ ArrayList<Dog> dogs = new ArrayList<Dog> () ; 




□ List<Dog> dogList = dogs; 



□ ArrayList<Object> objects = new ArrayList<Object> () ; 



□ List<Object> objList = objects; 



□ ArrayList<Object> objs = new ArrayList<Dog> () ; 
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collections with generics 



import java. Util.*; 

public class SortMountains { 

LinkedList<Mountain> mtn = new LinkedList<Mountain> ( ) ; 



Solution to the “Reverse 
Engineer” sharpen exercise 



class Namecompare implements Comparator < Mountain > { 

public int compare (Mountain one. Mountain two) { 



return one . name . compareT o(two . name) ; 

} 

} 

class Heightcompare implements Comparator <Mountain> { 

public int compare (Mountain one. Mountain two) { 



return (two. height - one. height); 

} 

} 

public static void main (String [] args ) { 
new SortMountain ( ) . go ( ) ; 

} 

public void go( ) { 

mtn. add (new Mountain ( "Longs" , 14255)); 
mtn. add (new Mountain ( "Elbert" , 14433)); 
mtn. add (new Mountain ( "Maroon" , 14156)); 
mtn. add (new Mountain ( "Castle" , 14265)); 




>,d that the ,s 

, PtSCEKPlN^ se<\<*ente . ■ 



System. out .println( "as entered: \n" + mtn); 
NameCompare nc = new NameCompare ( ) ; 

Collections. sort(mtn, nc); 

System. out .println( "by name:\n" + mtn); 
HeightCompare he = new HeightCompare () ; 

Collections. sort(mtn, he); 

System. out .println( "by height: \n" + mtn); 

} 

} 



class Mountain { 

String name; 
int height; 

Mountain(String n, int h) { 
name = n; 
height = h; 

} 

public String toString( ) { 
return name + " " + height; 

} 
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fill-in-the-blank solution 



Exercise Solution 

Possible Answers: 

Comparator, 
Comparable, 
compareTo( ), 
compare( ), 
yes, 
no 



Given the following compilable statement: 

Collections . sort (myArrayList) ; 

1. What must the class of the objects stored in myArrayList implement? Comparable 

2. What method must the class of the objects stored in myArrayList implement? COmpareTo( ) 

3. Can the class of the objects stored in myArrayList implement both 

Comparator AND Comparable? yes 



Given the following compilable statement: 

Collections . sort (myArrayList, myCompare) ; 

4. Can the class of the objects stored in myArrayList implement Comparable? yes 

5. Can the class of the objects stored in myArrayList implement Comparator? yes 

6. Must the class of the objects stored in myArrayList implement Comparable? HO 

7. Must the class of the objects stored in myArrayList implement Comparator ? HO 

8. What must the class of the myCompare object implement? Comparator 

9. What method must the class of the myCompare object implement? C0IT\paP6( ) 
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collections with generics 




BE tt e compiler solution 



Compiles? 

□ ArrayList<Dog> dogsl = new ArrayList<Animal> () ; 

□ ArrayList<Animal> animalsl = new ArrayList<Dog> () 



List<Animal> list = new ArrayList<Animal> () 



□ ArrayList<Dog> dogs = new ArrayList<Dog> () 

□ ArrayList<Animal> animals = dogs; 



List<Dog> dogList = dogs; 



ArrayList<Object> objects = new ArrayList<Object> () ; 



List<Object> objList = objects; 



□ ArrayList<Object> objs = new ArrayList<Dog> () 
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1 7 package, jars and deployment 



Release Your Code 




It’s time to let go. You wrote your code. You tested your code. You refined your code. 

You told everyone you know that if you never saw a line of code again, that'd be fine. But in the 
end, you've created a work of art. The thing actually runs! But now what? How do you give it to 
end users? Wh a t exactly do you give to end users? What if you don't even know who your end 
users are? In these final two chapters, we'll explore how to organize, package, and deploy your 
Java code. We'll look at local, semi-local, and remote deployment options including executable 
jars, Java Web Start, RMI, and Servlets. In this chapter, we'll spend most of our time on organizing 
and packaging your code — things you'll need to know regardless of your ultimate deployment 
choice. In the final chapter, we'll finish with one of the coolest things you can do in Java. Relax. 
Releasing your code is not saying goodbye.There's always maintenance... 

this is a new chapter 581 
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Java deployment 



Peploymg your application 

What exactly is a Java application? In other words, 
once you’re done with development, what is it that you 
deliver? Chances are, your end-users don’t have a system 
identical to yours. More importantly, they don’t have your 
application. So now it’s time to get your program in shape 
for deployment into The Outside World. In this chapter, 
we’ll look at local deployments, including Executable Jars 
and the part-local/part-remote technology called Java Web 
Start. In the next chapter, we’ll look at the more remote 
deployment options, including RMI and Servlets. 



Deployment options 




100% Local Combination 100% Remote 



A Java program is a bunch 
of classes. That’s the 
output of your development. 

The real question is what 
to do with those classes 
when you’re done. 



(7) Local 

The entire application runs on the 
end-user's computer, as a stand-alone, 
probably GUI, program, deployed as 
an executable JAR (we'll look at JAR 
in a few pages.) 

( 5 ) Combination of local and remote 

The application is distributed with a 
client portion running on the user's 
local system, connected to a server 
where other parts of the application 
are running. 

(3) Remote 

The entire Java application runs on a 
server system, with the client accessing 
the system through some non-Java 
means, probably a web browser. 




0 

Brain Barbell 

What are the advantages and 
disadvantages of delivering your 
Java program as a local, stand- 
alone application running on 
the end-user's computer? 

What are the advantages and 
disadvantages of delivering your 
Java program as web-based 
system where the user interacts 
with a web browser, and the 
Java code runs as servlets on the 
server? 



But before we really get into the whole deployment thing, 
let’s take a step back and look at what happens when you’ve 
finished programming your app and you simply want to pull 
out the class files to give them to an end-user. What’s really 
in that working directory? 
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package, jars and deployment 




Imagine this scenario... 




Bob’s happily at work on the final pieces of his cool new 
Java program. After weeks of being in the “I’m-just- 
one-compile-away” mode, this time he’s really 
done. The program is a fairly sophisticated 
GUI app, but since the bulk of it is Swing 
code, he’s made only nine classes of his 
own. 



At last, it’s time to deliver the program to the 
client. He figures all he has to do is copy the 
nine class files, since the client already has 
the Java API installed. He starts by doing an 
Is on the directory where all his files are... 




Whoa! Something strange has happened. Instead of 18 
files (nine source code files and nine compiled class 
files), he sees 31 files, many of which have very strange 
names like: 




AccountfFileListener.class 
Chart$SaveLis tener. class 



and on it goes. He had completely forgotten 
that the compiler has to generate class files 
for all those inner class GUI event listeners 
he made, and that’s what all the strangely- 
med classes are. 



he has to carefully extract all the class 
files he needs. If he leaves even one of them out, 
his program won’t work. But it’s tricky since he 
doesn’t want to accidentally send the client 
one of his source code files, yet everything is 
in the same directory in one big mess. 
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organizing your classes 



Separate source code and class files 

A single directory with a pile of source code and class files is a 
mess. It turns out, Bob should have been organizing his files 
from the beginning, keeping the source code and compiled 
code separate. In other words, making sure his compiled class 
hies didn’t land in the same directory as his source code. 

The key is a combination of directory structure organization and the 
-d compiler option. 

There are dozens of ways you can organize your hies, and your 
company might have a specihc way they want you to do it. We 
recommend an organizational scheme that’s become almost 
standard, though. 

With this scheme, you create a project directory, and inside 
that you create a directory called source and a directory called 
classes. You start by saving your source code (.java hies) into 
the source directory. Then the trick is to compile your code 
in such a way that the output (the .class hies) ends up in the 
classes directory. 

And there’s a nice compiler hag, -d, that lets you do that. 




Compiling with the -d (directory) flag 



MyApp . j ava 

\ 

to* ' ast H"V SS ^' a 

nan* yej 

if ile -to Compile 



%cd MyProject/ source 
%javac -d ../classes 

“Ik -the Compiler to pu l ii 

£o rr}'d £°d e (dass & es ) 

iJ*J he directory 

back w ° ne ^ U P a »d 
back down again (Vom the 

* eni directory. 

By using the -d hag, you get to decide which directory the 
compiled code lands in, rather than accepting the default of 
class hies landing in the same directory as the source code. 
To compile all the .java hies in the source directory, use: ^ 

%javac -d ../classes *.java 

* java Compiles Ab-L 

sourde files in the 
Current directory 

%cd MyProject/classes 



MyProject 



tompiled code 
lands here 



> your * 
rom here 






Running your code 



MyApp.class 



compile £rom 
THIS directory 



1 




classes | 


source 1 



101101 VN 




Lorper ^ 


101101 




iure eugue 


10101000010 




tat vero 


1010 10 0 




conse 


01010 1 




eugueroLore 


1010101 




do eliquis 


10101010 




do del dip 


1001010101 







MyApp.java 



%java Mini 
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package, jars and deployment 



Pot your Java in a JAR. 




AJAR file is a Java ARchive. It’s based on the pkzip file format, and it lets you bundle 
all your classes so that instead of presenting your client with 28 class files, you hand 
over just a single JAR file. If you’re familiar with the tar command on UNIX, you’ll 
recognize the jar tool commands. (Note: when we say JAR in all caps, we’re referring 
to the archive file. When we use lowercase, we’re referring to the jar toolyou use to 
create JAR files.) 

The question is, what does the client do with the JAR? How do you get it to run ? 



You make the JAR executable. 



An executable JAR means the end-user doesn’t have to pull the class files out before 
running the program. The user can run the app while the class files are still in the 
JAR. The trick is to create a manifest file, that goes in the JAR and holds information 
about the files in the JAR. To make a JAR executable, the manifest must tell the JVM 
which class has the main() method! 



Making an executable JAR 

(J) Make sure all of your class files are in 
the classes directory 

We're going to refine this in a few pages, but 
for now, keep all your class files sitting in the 
directory named classes'. 



I MyProject ( 

L J 

rr~ 

classes 1 

L j 






10101000010 






101101 
101101 
10101000010 
1010 10 0 
01010 1 
1010101 
10101010 
1001010101 



MyApp.class 



(2) Create a manifest.txt file that states 
which class has the main() method 



Make a text file named manifest.txt that has a 
one line: 

don’t dass 

Main-Class: MyApp ^ ^ er ,d 



Press the return key after typing the Main- 
Class line, or your manifest may not work 
correctly. Put the manifest file into the "classes" 
directory. 




( 3 ) Run the jar tool to create a JAR file 
that contains everything in the classes 
directory, plus the manifest. 



%cd MiniProject/ classes 

%jar -cvmf manifest.txt appl.jar *. class 
OR 



%jar -cvmf manifest.txt appl 



jar MyApp.class 



manifest.txt 




no souvCC 

code (java) 

\n the JAR 
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executable JAR 




100% Local Combination 100% Remote 



Most 100% local Java 
apps are deployed as 
executable JAR files. 



Running (executing) the JAR 

Java (the JVM) is capable of loading a class from a JAR, and calling 
the main() method of that class. In fact, the entire application can 
stay in the JAR. Once the ball is rolling (i.e., the main() method 
starts running), the JVM doesn’t care where your classes come 
from, as long as it can find them. And one of the places the JVM 
looks is within any JAR files in the classpath. If it can see a JAR, the 
JVM will look in that JAR when it needs to find and load a class. 



%cd MyProject/classes 




% java 






-jar appl.jar 

t X 

X- 



The JVM has to 'see' the OAR. so 

it must be m yo«r tlasspath. The 
easiest xav to make the JAR visible 
is -to make your working a»ve£t°vy 

- ylace the JAR « s - 



ar r 

a W\s M *° r 



Depending on how your operating system is configured, you 
might even be able to simply double-click the JAR file to launch 
it. This works on most flavors of Windows, and Mac OS X. You 
can usually make this happen by selecting the JAR and telling 
the OS to “Open with...” (or whatever the equivalent is on your 
operating system) . 



-tJiereiqreJiP 

Dumb Questions 




Why can't I just JAR up an entire directory? 




What did you just say? 



The JVM looks inside the JAR and expects to find 
what it needs right there. It won't go digging into other 
directories, unless the class is part of a package, and even 
then the JVM looks only in the directories that match the 
package statement? 



A- 

r \ m You can't put your class files into some arbitrary 
directory and JAR them up that way. But if your classes 
belong to packages, you can JAR up the entire package 
directory structure. In fact, you must. We'll explain all this on 
the next page, so you can relax. 
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package, jars and deployment 



Put your classes in packages! 




So you’ve written some nicely reusable class files, and you’ve 
posted them in your internal development library for other 
programmers to use. While basking in the glow of having 
just delivered some of the (in your humble opinion) best 
examples of OO ever conceived, you get a phone call. A 
frantic one. Two of your classes have the same name as 
the classes Fred just delivered to the library. And all hell is 
breaking loose out there, as naming collisions and ambiguities 
bring development to its knees. 

And all because you didn’t use packages! Well, you did use 
packages, in the sense of using classes in the Java API that are, 
of course, in packages. But you didn’t put your own classes 
into packages, and in the Real World, that’s Really Bad. 



Package structure of the Java API for: 



We’re going to modify the organizational structure from the 
previous pages, just a little, to put classes into a package, and 
to JAR the entire package. Pay very close attention to the 
subtle and picky details. Even the tiniest deviation can stop 
your code from compiling and/ or running. 

Packages prevent class name conflicts 



java.text.NumberFormat 

java.util.ArrayList 

java.awt.FlowLayout 

java.awt.event.ActionEvent 

java.net.Socket 



Although packages aren’t just for preventing name collisions, 
that’s a key feature. You might write a class named Customer 
and a class named Account and a class named ShoppingCart. 
And what do you know, half of all developers working in 
enterprise e-commerce have probably written classes with 
those names. In an OO world, that’s just dangerous. If part of 
the point of OO is to write reusable components, developers 
need to be able to piece together components from a 
variety of sources, and build something new out of them. 

Your components have to be able to ‘play well with others’, 
including those you didn’t write or even know about. 

Remember way back in chapter 6 when we discussed how 
a package name is like the full name of a class, technically 
known as the fully-qualified name. Class ArrayList is really 
java.utiLArrayList, JButton is really javax. swing JButton, and 
Socket is really java.net.Socket. Notice that two of those classes, 
ArrayList and Socket, both have java as their “first name”. 

In other words, the first part of their fully-qualified names 
is “java”. Think of a hierarchy when you think of package 
structures, and organize your classes accordingly. 



java 




ActionEvent 



What does this picture look like to 
you? Doesn't it look a whole lot like 
a directory hierarchy? 
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package naming 




Preventing package name conflicts 

Putting your class in a package reduces the chances of naming 
conflicts with other classes, but what’s to stop two programmers 
from coming up with identical package names? In other words, 
what’s to stop two programmers, each with a class named Account, 
from putting the class in a package named shopping. customers? 
Both classes, in that case, would still have the same name: 

shopping. customers.Account 

Sun strongly suggests a package naming convention that greatly 
reduces that risk — prepend every class with your reverse domain 
name. Remember, domain names are guaranteed to be unique. 
Two different guys can be named Bartholomew Simpson, but two 
different domains cannot be named doh.com. 



Packages can prevent name 
conflicts, but only if you 
choose a package name 
that’s guaranteed to be 
unique. The best way to 
do that is to preface your 
packages with your reverse 
domain name. 



com.headfirstbooks.Book 



padkage name 



C 



t\a sS 









Reverse domain package names 

com. headfirst java.projects.Chart < — 



t \ass 









V-CVCV* sc 



start the padkage ™tV> ** 
domain, separated by a dot u, 
then add youv own organizational 
strudtwre atter that 



projedts, Chart ">'3^ be a dom.on 

name, but adding dom.headtirstiava 
means we have to worry about only 
ouv~ oy iv\ in— bouse developers. 
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package, jars and deployment 



To put your class in a package: 

© Choose a package name 

We're using com.headfirstjava as our 
example. The class name is PackageExercise, 
so the fully-qualified name of the class is now: 

com . headfirstjava . PackageExercise. 

(2) Put a package statement in your class 

It must be the first statement in the source 
code file, above any import statements. There 
can be only one package statement per source 
code file, so all classes in a source file must 
be in the same package. That includes inner 
classes, of course. 



package com . headfirst j ava ; 



import j avax . swing . * ; 

public class PackageExercise { 
// life-altering code here 

} 



(D Set up a matching directory structure 

It's not enough to say your class is in a package, 
by merely putting a package statement in 
the code. Your class isn't truly in a package 
until you put the class in a matching directory 
structure. So, if the fully-qualified class name 
is com.headfirstjava.PackageExercise, you 
must put the PackageExercise source code in a 
directory named headfirstjava, which must be in 
a directory named com. 

It is possible to compile without doing that, but 
trust us— it's not worth the other problems 
you'll have. Keep your source code in a directory 
structure that matches the package structure, 
and you'll avoid a ton of painful headaches down 
the road. 



You must put a class 
into a directory 
structure that matches 
the package hierarchy. 






£_ 

ZJ 




a 

Q_ 




classes 



headfirstjava 



headfirstjava 



MyProject 



source 



Lorper ^ 
lure eugue 

eugueroLore 
do eliquis 
do del dip 



PackageExercise.class PackageExercise.java 

Set up a matching directory structure for 
both the source and classes trees. 
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compile and run with packages 



Compiling and running with packages 

When your class is in a package, it’s a little trickier to compile and 
run. The main issue is that both the compiler and JVM have to be 
capable of finding your class and all of the other classes it uses. 
For the classes in the core API, that’s never a problem. Java always 
knows where its own stuff is. But for your classes, the solution 
of compiling from the same directory where the source hies are 
simply won’t work (or at least not reliably). We guarantee, though, 
that if you follow the structure we describe on this page, you’ll be 
successful. There are other ways to do it, but this is the one we’ve 
found the most reliable and the easiest to stick to. 



Compiling with the -d (directory) flag 

sbv - m souvde diretW Po NOT U do- 

%cd MyProject/ source Jiv-edW/ whev-e w j ava c ,s - 



%javac -d ../classes 

, 

tells the con, pil^ £ he 
tolled Code (class 

directory, 



qht o ackJj 

sbraturell /es,Tiw: 



com/headfirst java/ PackageExer else . java 



|s(ow '1°* ^ av ( c 

a tM «uvte We- 



To compile all the .java hies in the com.headhrstjava 
package, use: 



%javac -d ../classes 



com/headfirst java/* . java 



Running your code 

%cd MyProject/classes c ditred-fe< 



^ IT -fi 

' '.ory. 






% java com. headfirst java . PackageExer else 

V°« AJWST aj v , 4-1. r I. 




low II still tortile 
ro» keve 



d^cdio\ry, om C v Ch i* C »*!f ss ’ ^ dass * "T » PackageExercise.class PackageExercise.java 

iasscs , it woh ; t work I tovn 
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package, jars and deployment 



The -d flag is even cooler than we said 



Dun! iTt^uest! °ns 



Compiling with the -d flag is wonderful because not only does it 
let you send your compiled class files into a directory other than 
the one where the source file is, but it also knows to put the class 
into the correct directory structure for the package the class is in. 

But it gets even better! 

Let’s say that you have a nice 
directory structure all set up for your 
source code. But you haven’t set 
up a matching directory structure 
for your classes directory. Not a 
problem! Compiling with 
-d tells the compiler to not 
just put your classes into 
correct directory tree, but to 
the directories if they don’t 



|{ the yatkay diretbry sWWe 
doesn't e*ist under the passes 
diredW/, the eonf.ler will Ud the 
directories it Y ow ^ 

So vou don’t actually kave to 

phvsicallY Create the direttor.es under 
the 'classes' root directory. And m 
■fafrt, i-f Y ow ' e ^ the Compiler do .t 
there’s no chance ot a tY?o- 




headfirstjava 



LorpeO 



PackageExercise.java 



The -d flag tells the compiler, 
“Put the class into its package 
directory structure, using the 
class specified after the -d as 
the root directory. But... if the 
directories aren’t there, create 
them first and then put the class 
in the right place!” 



v; I tried to cd into the 
directory where my main class 
was, but now the JVM says it can't 
find my class! But it's right THERE 
in the current directory! 

A* 

Jr \ m Once your class is in a 
package, you can't call it by its 
'short' name. You MUST specify, 
at the command-line,the fully- 
qualified name of the class whose 
main() method you want to run. 

But since the fully-qualified name 
includes the package structure, 
Java insists that the class be in a 
matching directory structure. So if 
at the command-line you say: 

%java com. foo. Book 

the JVM will look in its current 
directory (and the rest of its 
classpath), for a directory named 
"com" It will not look for a class 
named Book, until it has found 
a directory named "com" with a 
directory inside named "foo". Only 
then will the JVM accept that its 
found the correct Book class. If it 
finds a Book class anywhere else, 
it assumes the class isn't in the 
right structure, even if it is! The 
JVM won't for example, look back 
up the directory tree to say, "Oh, I 
can see that above us is a directory 
named com, so this must be the 
right package..." 
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JARs and packages 



Making an executable JAR with packages 




When your class is in a package, the package directory structure 
must be inside the JAR! You can’t just pop your classes in the 
JAR the way we did pre-packages. And you must be sure that you 
don’t include any other directories above your package. The 
first directory of your package (usually com) must be the first 
directory within the JAR! If you were to accidentally include the 
directory above the package (e.g. the “classes” directory), the JAR 
wouldn’t work correctly. 



Making an executable JAR 

(V) Make sure all of your class files are 
within the correct package structure, 
under the classes directory. 



(2) Create a manifest.txt file that states 
which class has the main() method, 
and be sure to use the fully -qualified 
class name! 

Make a text file named manifest.txt that has a 
single line: 

Main-Class : com. headfirst java . PackageExercise 
Put the manifest file into the classes directory 




PackageExercise.class 




(D 



Run the jar tool to create 
that contains the package 
plus the manifest 

The only thing you need to include 
directory, and the entire package 
will go into the JAR. 

%cd MyProject/classes 



a JAR file 
directories 



is the 'com' 

(and all classes) 



M v* m r v 



the 




101101 p 
10 no 1 
0 11 0 




%jar -cvmf manifest.txt packEx.jar 



PackageExercise.class 
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package, jars and deployment 



So where did the manifest file go? 

Why don’t we look inside the JAR and find out? From the 
command-line, the jar tool can do more than just create and run a 
JAR. You can extract the contents of a JAR (just like ‘unzipping’ or 
‘untarring’). 

Imagine you’ve put the packEx.jar into a directory named Skyler. 



jar commands for listing and extracting 



(V) List the contents of a JAR 

% jar -tf packEx.jar 

T -W stends < T y, _ , 
l,ow a Ul e of it ,a „*> 

°+ the J/\R f ile" 






Skyler 

L MM ■ J 



% cd Skyler 

% jar -tf packEx.jar 

META-INF/ 

META-INF/MANIFEST . MF 
com/ 

com/he adf irstj ava/ 
com/he adf irstj ava/ 
PackageExercise . class 



(2) Extract the contents of a JAR (i.e. unjar) 

% cd Skyler 
% jar -xf packEx.jar 

T 

_*f stands for ‘fcutrafct P' ,,e ’ av,d 

w0 rks vust l-ke «nzi ?? m 3 or u«W<rm<V 

|f vou wtradt tkej-atkE^ar, y<*'J 
see tke M&TA-INP diredtory and tke 
tom d-redtory diredtory in youir durrent 
diredtory 



^ on> at>ta"'l 



af 



packEx.jar 



r^a^'' 



META-INF 



) [3 



Main-Class: MiniApp 



MANIFEST.MF 



headfirstjavi 



3 



101101 p 
10 no 1 
0 11 0 




PackageExercise.class 

META-INF stands for ’meta 
information. The jar tool creates 
the META-INF directory as 
well as the MANIFEST.MF file. 
It also takes the contents of 
your manifest file, and puts it 
into the MANIFEST.MF file. So, 
your manifest file doesn't go into 
the JAR, but the contents of it 
are put into the real' manifest 
(MANIFEST.MF). 



PackageExercise.class 
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organizing your classes 



waipcn yuui pci mi 




MyProject 



source 



manifest.txt 



javaranch 



javaranch 



cows 



cows 



101101 p 
10 110 1 




LorpeJ^ 


0 11 0 
001 10 




taHero 






euguero- 



Foof.class Foof.java 



Given the package/directory structure in this 
picture, figure out what you should type at the 
command-line to compile, run, create a JAR, and 
execute a JAR. Assume we're using the standard 
where the package directory structure starts just 
below source and classes. In other words, the source 
and classes directories are not part of the package. 



Compile: 

%cd source 
% javac 

Run: 

%cd 

%java 



Create a JAR 

%cd 

% 

Execute a JAR 

%cd 

% 

Bonus question:What's wrong with the package name? 
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package, jars and deployment 



fjiereictrerip 

Dumb Questions 



What happens if you try 
to run an executable JAR, and 
the end-user doesn't have java 
installed? 



Nothing will run, since 
without a JVM, Java code can't 
run. The end-user must have Java 
installed. 



How can I get Java 
installed on the end-user's 
machine? 



Ideally, you can create a custom 
installer and distribute it along 
with your application. Several 
companies offer installer pro- 
grams ranging from simple to 
extremely powerful. An installer 
program could, for example, de- 
tect whether or not the end-user 
has an appropropriate version 
of Java installed, and if not, 
install and configure Java before 
installing your application. 

I nstal Ishield, InstallAnywhere, 
and DeployDirector all offer Java 
installer solutions. 



Another cool thing about some 
of the installer programs is that 
you can even make a deploy- 
ment CD-ROM that includes 
installers for all major Java 
platforms, so... one CD to rule 
them all. If the user's running on 
Solaris, for example, the Solaris 
version of Java is installed. On 
Windows, the Windows, ver- 
sion, etc. If you have the budget, 
this is by far the easiest way for 
your end-users to get the right 
version of Java installed and 
configured. 



■ Organize your project so that your source code and class files are not in 
the same directory. 

■ A standard organization structure is to create a project directory, and then 
put a source directory and a classes directory inside the project directory. 

■ Organizing your classes into packages prevents naming collisions with 
other classes, if you prepend your reverse domain name on to the front of 
a class name. 

■ To put a class in a package, put a package statement at the top of the 
source code file, before any import statements: 

package com . wickedlysmart ; 

■ To be in a package, a class must be in a directory structure that exactly 
matches the package structure. For a class, com.wickedlysmart.Foo, 
the Foo class must be in a directory named wickedlysmart, which is in a 
directory named com. 

■ To make your compiled class land in the correct package directory 
structure under the classes directory, use the -d compiler flag: 

% cd source 

% javac -d ../classes com/ wickedlysmart/Foo . java 

■ To run your code, cd to the classes directory, and give the fully-qualified 
name of your class: 

% cd classes 

% j ava com . wickedlysmart . Foo 

■ You can bundle your classes into JAR (Java ARchive) files. JAR is based 
on the pkzip format. 

■ You can make an executable JAR file by putting a manifest into the JAR 
that states which class has the main() method. To create a manifest file, 
make a text file with an entry like the following (for example): 
Main-Class : com . wickedlysmart . Foo 

■ Be sure you hit the return key after typing the Main-Class line, or your 
manifest file may not work. 

■ To create a JAR file, type: 

jar -cvfm manifest.txt MyJar. jar com 

■ The entire package directory structure (and only the directories matching 
the package) must be immediately inside the JAR file. 

■ To run an executable JAR file, type: 

java -jar MyJar. jar 
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wouldn’t it be dreamy... 



Executable JAR files 
are nice, but wouldn't it be dreamy 
if there were a way to make a rich, stand- 
alone client GUI that could be distributed 
over the Web? So that you wouldn't have to 
press and distribute all those CD-ROMs. And 
wouldn't it be just wonderful if the program 
could automatically update itself , replacing 
just the pieces that changed? The clients 
would always be up-to-date, and you'd never 
have to worry about delivering new 
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package, jars and deployment 




100% Local Combination 100% Remote 



Java Web Start 

With Java Web Start (JWS), your application is launched for the 
first time from a Web browser (get it? Web Start?) but it runs as a 
stand-alone application (well, almost), without the constraints of the 
browser. And once it’s downloaded to the end-user’s machine (which 
happens the first time the user accesses the browser link that starts 
the download), it stays there. 

Java Web Start is, among other things, a small Java program that lives 
on the client machine and works much like a browser plug-in (the 
way, say, Adobe Acrobat Reader opens when your browser gets a .pdf 
hie). This Java program is called the Java Web Start ‘helper app’, 
and its key purpose is to manage the downloading, updating, and 
launching (executing) of yoiuJWS apps. 

When JWS downloads your application (an executable JAR), it 
invokes the main() method for your app. After that, the end-user can 
launch your application directory from the JWS helper app without 
having to go back through the Web page link. 

But that’s not the best part. The amazing thing about JWS is its 
ability to detect when even a small part of application (say, a single 
class hie) has changed on the server, and — without any end-user 
intervention — download and integrate the updated code. 

There’s still an issue, of course, like how does the end-user g^Java 
and Java Web Start? They need both — Java to run the app, and Java 
Web Start (a small Java application itself) to handle retrieving and 
launching the app. But even that has been solved. You can set things 
up so that if your end-users don’t have JWS, they can download 
it from Sun. And if they do have JWS, but their version of Java is 
out-of-date (because you’ve specihed in your JWS app that you 
need a specihc version of Java), the Java 2 Standard Edition can be 
downloaded to the end-user machine. 

Best of all, it’s simple to use. You can serve up a JWS app much like 
any other type of Web resource such as a plain old HTML page or a 
JPEG image. You set up a Web (HTML) page with a link to your JWS 
application, and you’re in business. 

In the end, your JWS application isn’t much more than an 
executable JAR that end-users can download from the Web. 



End-users launch a Java 
Web Start app by clicking 
on a link in a Web 
page. But once the app 
downloads, it runs outside 
the browser, just like any 
other stand-alone Java 
application. In fact, a 
Java Web Start app is just 
an executable JAR that’s 
distributed over the Web. 
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Java Web Start 



How Java Web Start works 

^ The client clicks on a Web page link 
to your JWS application (a .jnlp file). 

The Web page link 

<a href="MyApp . jnlp">Click</a> 




(2) The Web server (HTTP) gets the 
request and sends back a .jnlp file 
(this is NOT the JAR). 

The .jnlp file is an XML document that 
states the name of the application's 
executable JAR file. 




MyApp.jnlp 



(3) Java Web Start (a small 'helper app' 
on the client) is started up by the 
browser. The JWS helper app reads 
the .jnlp file, and asks the server for 
the My App. jar file. 



Java Web Stsr't 




"give me MyApp.jar" 



Web Server 



MyApp.jnlp MyApp.jar 



© 



The Web server serves' up the 
requested .jar file. 





tfdlolMebSfcav-fc 



(5) Java Web Start gets the JAR and 
starts the application by calling the 
specified main( ) method (just like an 
executable JAR). 

Next time the user wants to run this app, he can 
open the Java Web Start application and from 
there launch your app, without even being online. 




app i* the J/\R) 
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package, jars and deployment 



The .jnlp flic 



To make a Java Web Start app, you need to .jnlp (Java Network 
Launch Protocol) file that describes your application. This is the 
hie the JWS app reads and uses to find your JAR and launch the 
app (by calling the JAR’s main() method). A .jnlp hie is a simple 
XML document that has several different things you can put in, 
but as a minimum, it should look like this: 



<?xml version="l . 0" encoding="utf-8"?> 



r i-Ve. Vo°^ 

. ’ A-ao, '"”7 or> ^ ,Ve vsw^ 






<jnlp spec="0.2 1.0" 

codebase="http : //127 . 0 . 0 . l/~kathy 
href="MyApp . jnlp"> 



ru to acv " \ota\^T>> 

X 1 ito o*' c ® jlus ^ 

iv i ^ «* 

/— • 'ft,. «■ •* •* A "* 

S3'(> W X 

-jvathy" , 

j «* «* —• 

nested m some otKev &trttb*y- 



not wovk dovrettlY. r displav'mOi when tke user 



<information> 

<title>kathy App</title> 

<vendor>Wickedly Smart</vendor> 

<homepage href =" index. html"/> 

<description>Head First WebStart demo</description> 

<icon href="kathys . gif "/> 

nr^<w. 



<resources> 

<j2se version="l . 3+"/> t 
< j ar hr e f = "MyApp . j ar " / > 
</resources> 



This says that yowr av? version 1.5 

" ^ o-f Java, or yrcaicr. 



<application-desc main-class="HelloWebStart"/> 
</ jnlp> 



This is like -the mam-Pesf, Ma’m-Class errtv-y... i-t says 
*/ki£k elass in ike J /\R kas ike mainO rwetkod. 
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deploying with JWS 



Steps for making and deploying 
a Java Web Start app 



© 



Make an executable JAR 
for your application. 

MyApp.jar 




© 



Write a .jnlp file. 




MyApp.jnlp 



(5) Place your JAR and .jnlp 
files on your Web server. 



Web Server 







Lorpei 

<iure 




>.html 



3 



MyApp.jnlp MyApp.jar 



(4) Add a new mime type to your Web server. 

application/x- java- j nip-file 

This causes the server to send the .jnlp file with the 
correct header, so that when the browser receives 
the .jnlp file it knows what it is and knows to start 
the JWS helper app. 



Web Server 



configure 
mime type 



© 



Create a Web page with a link 

to your .jnlp file 

<HTML> 

<BODY> 




MyJWSApp.html 



<a href="MyApp2 . jnlp">Launch My Application</a> 
</BODY> 

</HTML> 
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package, jars and deployment 




Look at the sequence of events below, and 
place them in the order in which they 
occur in a JWS application. 



server sends a JAR "1 4 - 

■^vJebbrowsersterts up U We to the JWS helper app I 







the JAR fite — * 




1 me Web server sends \ 
file to the browser 






the JWS helper app invokes 
the JAR’s mainQ method 


user clicks a Web page link I 


"browser requests a .jnlp file 
from the Web server 





Dumb Questions 

% How is Java Web Start different from an applet? 

A- 

Jr \* Applets can't live outside of a Web browser. An applet is 
downloaded from the Web as part of a Web page rather than 
simply from a Web page. In other words, to the browser, the applet 
is just like a JPEG or any other resource.The browser uses either a 
Java plug-in or the browser's own built-in Java (far less common 
today) to run the applet. Applets don't have the same level of 
functionality for things such as automatic updating, and they must 
always be launched from the browser. With JWS applications, once 
they're downloaded from the Web, the user doesn't even have to 
be using a browser to relaunch the application locally. Instead, 
the user can start up the JWS helper app,and use it to launch the 
already-downloaded application again. 




What are the security restrictions of JWS? 



A- 

- r \ m JWS apps have several limitations including being 
restricted from reading and writing to the user's hard drive. But... 
JWS has its own API with a special open and save dialog box so 
that, with the user's permission, your app can save and read its 
own files in a special, restricted area of the user's drive. 



■ Java Web Start technology lets you deploy a 
stand-alone client application from the Web. 

■ Java Web Start includes a ‘helper app’ that must 
be installed on the client (along with Java). 

■ A Java Web Start (JWS) app has two pieces: 
an executable JAR and a .jnlp file. 

■ A .jnlp file is a simple XML document that 
describes your JWS application. It includes 
tags for specifying the name and location of the 
JAR, and the name of the class with the main() 
method. 

■ When a browser gets a .jnlp file from the server 
(because the user clicked on a link to the .jnlp 
file), the browser starts up the JWS helper app. 

■ The JWS helper app reads the .jnlp file and 
requests the executable JAR from the Web 
server. 

■ When the JWS gets the JAR, it invokes the 
main() method (specified in the .jnlp file). 
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We explored packaging, deployment, and JWS 
in this chapter. Your job is to decide whether 
each of the following statements is true or false. 



feTw on Fa i*se 




1. The Java compiler has a flag, -d, that lets you decide where your .class hies should go. 

2. AJAR is a standard directory where your .class hies should reside. 

3. When creating a Java Archive you must create a hie called jar. mf. 

4. The supporting hie in a Java Archive declares which class has the main() method. 

5. JAR hies must be unzipped before the JVM can use the classes inside. 

6 . At the command line, Java Archives are invoked using the -arch hag. 

7. Package structures are meaningfully represented using hierarchies. 

8 . Using your company’s domain name is not recommended when naming packages. 

9. Different classes within a source hie can belong to different packages. 

10. When compiling classes in a package, the -p hag is highly recommended. 

11. When compiling classes in a package, the full name must mirror the directory tree. 

12. Judicious use of the -d hag can help to assure that there are no typos in your class tree. 

13. Extracting a JAR with packages will create a directory called meta-inf. 

14. Extracting a JAR with packages will create a hie called manifest.mf. 

15. The JWS helper app always runs in conjunction with a browser. 

16. JWS applications require a .nip (Network Launch Protocol) hie to work properly. 

17. AJWS’s main method is specihed in its JAR hie. 
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41 
















42 

























Anything in the book 
is fair game for this 
one! 



Across 




Down 






6. Won't travel 


26. Mine is unique 


1. Pushy widgets 


16. Who's allowed 


30. I/O cleanup 


9. Don't split me 


27. GUI's target 


2. of my desire 


1 9. Efficiency expert 


31. Milli-nap 


10. Release-able 


29. Java team 


3. 'Abandoned' moniker 


20. Early exit 


34. Trig method 


1 1 . Got the key 


30. Factory 


4. A chunk 


21 . Common wrapper 


36. Encaps method 


12. I/O gang 


32. For a while 


5. Math not trig 


23. Yes or no 


38. JNLP format 


15. Flatten 


33. Atomic *8 


6. Be brave 


24. Java jackets 


39. VB's final 


17. Encapsulated returner 


35. Good as new 


7. Arrange well 


26. Not behavior 


40. Java branch 


18. Ship this one 


37. Pairs event 


8. Swing slang 


28. Socket's suite 




21. Make it so 


41 . Where do 1 start 


11.1/0 canals 






22. I/O sieve 


42. A little firewall 


13. Organized release 






25. Disk leaf 




14. Not for an instance 
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exercise solutions 




1 . 



2 . 




user clicks a Web page link 



browser requests a .jnlp file 
from the Web server 



3. 



the Web server sends a .jnlp 
file to the browser 



7. 



the Web browser starts up 
the JWS helper app 

”^e^j\WsT\eipeTapp requests | 

the JAR 

the Web server sends a JAR i 
We to the J WS helper ann 

the JWS helper app invokes 
the JAR’s mainQ method 
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package, jars and deployment 
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1 8 remote deployment with RMI 







Distributed 
Computing 



~ Everyone says long- 
distance relationships are hard 
but with RMI, it's easy. No 
matter how far apart we really 



are, RMI makes it seem like 
s. we're together. 



Being remote doesn’t have to be a bad thing. Sure, things are easier when 



all the parts of your application are in one place, in one heap, with one JVM to rule them all. But 



that's not always possible. Or desirable. What if your application handles powerful computations, 



but the end-users are on a wimpy little Java-enabled device? What if your app needs data 



from a database, but for security reasons, only code on your server can access the database? 



Imagine a big e-commerce back-end, that has to run within a transaction-management system? 



Sometimes, part of your app must run on a server, while another part (usually a client) must 
run on a different machine. In this chapter, we'll learn to use Java's amazingly simple Remote 
Method Invocation (RMI) technology. We'll also take a quick peek at Servlets, Enterprise Java 



Beans (EJB) ,and Jini,and look at the ways in which EJB and Jini depend on RMI. We'll end the 
book by writing one of the coolest things you can make in Java, a universal service browser. 
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how many heaps? 




100% Local Combination 100% Remote 



Method calls are always between 
two objects on the same heap. 

So far in this book, every method we’ve invoked has been on 
an object running in the same virtual machine as the caller. 
In other words, the calling object and the callee (the object 
we’re invoking the method on) live on the same heap. 

class Foo { 

void go ( ) { 

Bar b = new Bar ( ) ; 
b . doStuff () ; 

} 

public static void main (String [] args) { 
Foo f = new Foo ( ) ; 
f .go() ; 

} 

} 

In the code above, we know that the Foo instance 
referenced by /and the Bar object referenced by b are 
both on the same heap, run by the same JVM. Remember, 
the JVM is responsible for stuffing bits into the reference 
variable that represent how to get to an object on the heap. 

The JVM always knows where each object is, and how to 
get to it. But the JVM can know about references on only 
its own heap! You can’t, for example, have a JVM running 
on one machine knowing about the heap space of a JVM 
running on a different machine. In fact, a JVM running on 
one machine can’t know anything about a different JVM 
running on the same machine. It makes no difference if 
the JVMs are on the same or different physical machines; 
it matters only that the two JVMs are, well, two different 
invocations of the JVM. 




In most applications, when one object 
calls a method on another, both objects 
are on the same heap. In other words, 
both are running within the same JVM. 
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remote deployment with RMI 



What if you want to invoke a method on 
an object running on another machine? 



We know how to get information from one machine to another — 
with Sockets and I/O. We open a Socket connection to another 
machine, and get an OutputStream and write some data to it. 

But what if we actually want to call a method on something running 
in another machine... another JVM? Of course we could always build 
our own protocol, and when you send data to a ServerSocket the 
server could parse it, figure out what you meant, do the work, and 
send back the result on another stream. What a pain, though. Think 
how much nicer it would be to just get a reference to the object on 
the other machine, and call a method. 



Imagine two computers., 



H 'TP/- paih-ful/y 

sUj ^U{i J y 



JVM 



fr 4 do 









| JVM 








m 








h-H 


— \ 


n~ 


-1- 




=C 










1 





Cu\ fast, 

IS' 






Little Big 

Big has something Little wants. 

Compute powe r. 

Little wants to send some data to Big, so that Big can do the 
heavy computing. 

Little wants simply to call a method... 

double doCalcUsingDatabase (CalcNumbers numbers) 



and get hack the result. 

But how can Little get a reference to an object on Big? 
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two objects, two heaps 



Object A, running on Little, wants to call 
a method on Object ft running on ftig. 

The question is, how do we get an object on one machine 
(which means a different heap /JVM) to call a method on 
another machine? 




ftut you can't do that. 

Well, not directly anyway. You can’t get a reference to 
something on another heap. If you say: 

Dog d = ??? 

Whatever d is referencing must be in the same heap space as 
the code running the statement. 

But imagine you want to design something that will use 
Sockets and I/O to communicate your intention (a method 
invocation on an object running on another machine), yet 
still feel as though you were making a local method call. 

In other words, you want to cause a method invocation on a 
remote object (i.e., an object in a heap somewhere else), but 
with code that lets you pretend that you’re invoking a method 
on a local object. The ease of a plain old everyday method 
call, but the power of remote method invocation. That’s our 
goal. 

That’s what RMI (Remote Method Invocation) gives you! 

But let’s step back and imagine how you would design RMI if 
you were doing it yourself. Understanding what you’d have to 
build yourself will help you learn how RMI works. 
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remote deployment with RMI 



A design for remote method calls 



Create four things: server, client, 
server helper, client helper 



^ Create client and server apps. The server app is the 
remote service that has an object with the method 
that the client wants to invoke. 




Client heap 




Create client and server 'helpers'. They'll handle all 
the low-level networking and I/O details so your client 
and service can pretend like they're in the same heap. 
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client and server helpers 



The role of the 'helpers' 

The ‘helpers’ are the objects that actually do the communicating. 
They make it possible for the client to act as though its calling a 
method on a local object. In fact, it is. The client calls a method on 
the client helper, as if the client helper were the actual service. The client 
helper is a proxy for the Real Thing. 

In other words, the client object thinks it’s calling a method on 
the remote service, because the client helper is pretending to be 
the service object. Pretending to he the thing with the method the client 
wants to call! 

But the client helper isn’t really the remote service. Although the 
client helper acts like it (because it has the same method that the 
service is advertising), the client helper doesn’t have any of the 
actual method logic the client is expecting. Instead, the client 
helper contacts the server, transfers information about the method 
call (e.g., name of the method, arguments, etc.), and waits for a 
return from the server. 

On the server side, the service helper receives the request from 
the client helper (through a Socket connection), unpacks the 
information about the call, and then invokes the real method on 
the real service object. So to the service object, the call is local. It’s 
coming from the service helper, not a remote client. 

The service helper gets the return value from the service, packs it 
up, and ships it back (over a Socket’s output stream) to the client 
helper. The client helper unpacks the information and returns the 
value to the client object. 



Your client object gets to 
act like it’s making remote 
method calls. But what 
it’s really doing is calling 
methods on a heap-local 
‘prox/ object that handles 
all the low-level details of 
Sockets and streams. 
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remote deployment with RMI 



How the method call happens 




(5) Client helper packages up information about the call 
(arguments, method name, etc.) and ships it over the 




(3) Service helper unpacks the information from the client helper, 
finds out which method to call (and on which object) and 
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RMI helper objects 



Java VM\ gives you the client and 
service helper objects! 



In Java, RMI builds the client and service helper 
objects for you, and it even knows how to make the 
client helper look like the Real Service. In other 
words, RMI knows how to give the client helper 
object the same methods you want to call on the 
remote service. 

Plus, RMI provides all the runtime infrastructure to 
make it work, including a lookup service so that the 
client can find and get the client helper (the proxy 
for the Real Service). 

With RMI, you don’t write any of the networking 
or I/O code yourself. The client gets to call remote 
methods (i.e. the ones the Real Service has) just 
like normal method calls on objects running in the 
client’s own local JVM. 

Almost. 

There is one difference between RMI calls and local 
(normal) method calls. Remember that even though 
to the client it looks like the method call is local, 
the client helper sends the method call across the 
network. So there is networking and I/O. And what 
do we know about networking and I/O methods? 

They’re risky! 



They throw exceptions all over the place. 

So, the client does have to acknowledge the risk. The 
client has to acknowledge that when it calls a remote 
method, even though to the client it’s just a local call 
to the proxy/helper object, the call ultimately involves 
Sockets and streams. The client’s original call is local , 
but the proxy turns it into a remote call. A remote call 
just means a method that’s invoked on an object on 
another JVM. How the information about that call 
gets transferred from one JVM to another depends 
on the protocol used by the helper objects. 

With RMI, you have a choice of protocols: JRMP or 
HOP. JRMP is RMI’s ‘native’ protocol, the one made 
just for Java-to Java remote calls. HOP, on the other 
hand, is the protocol for CORBA (Common Object 
Request Broker Architecture), and lets you make 
remote calls on things which aren’t necessarily Java 
objects. CORBA is usually much more painful than 
RMI, because if you don’t have Java on both ends, 
there’s an awful lot of translation and conversion that 
has to happen. 

But thankfully, all we care about is Java-to Java, so 
we’re sticking with plain old, remarkably easy RMI. 



In RMI, the client helper is a ‘stub’ 
and the server helper is a ‘skeleton’. 
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remote deployment with RMI 



Making the Remote Service 

This is an overview of the five steps for making the remote 
service (that runs on the server). Don’t worry, each step is 
explained in detail over the next few pages. 



Step one: 

Make a Remote Interface 

The remote interface defines the methods 
that a client can call remotely. It’s what 
the client will use as the polymorphic class 
type for your service. Both the Stub and 
actual service will implement this! 



MyRemote.java 




Step two: 

Make a Remote Implementation 

This is the class that does the Real Work. 
It has the real implementation of the 
remote methods defined in the remote 
interface. It’s the object that the client 
wants to call methods on. 



MyRemotelmpl.java 



.The M SerV’te. TWe d** 
the methods that do 
the veal wovk. It implements 
■the v-ewo-te m* tev4ate. 



Step three: 

Generate the stubs and skeletons using rmic 

These are the client and server ‘helpers’. 

You don’t have to create these classes or ever 
look at the source code that generates them. 
It’s all handled automatically when you 
run the rmic tool that ships with your Java 
development kit. 

Step four: 

Start the RMI registry (rmiregistry) 

The rmiregistry is like the white pages of a 
phone book. It’s where the user goes to get 
the proxy (the client stub/helper object). 



Running vmifc a^mst tt* 

sevvite imyle^aaW t\as&~ 

| File Edit Window Help Eat | 



5 rmic MyRemotelmpl 



f h °i hew 

classes -fov the 
helpev objects 



101101 p 
10 110 1 
0 11 0 



MyRemotelmpLStub.class 

101101 P 



MyRemotelmpLSkel.class 



File Edit Window Help Drink 



^rmiregistry 



m a\ 

se? avaU^"' m3 ' 



Step five: 

Start the remote service 

You have to get the service object up and running. 

Your service implementation class instantiates an 
instance of the service and registers it with the RMI 
registry. Registering it makes the service available for 
clients. 
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a remote interface 



Step one: Make a Remote Interface 



© 



© 






Extend java . rmi . Remote 

Remote is a ‘marker’ interface, which means it has no methods. It has 
special meaning for RMI, though, so you must follow this rule. Notice 
that we say ‘extends’ here. One interface is allowed to extend another 
interface. 



MyRemote.java 



public interface MyRemote 



extends Remote 



{ 



Declare that all methods throw a RemoteException 

The remote interface is the one the client uses as the polymorphic type 
for the service. In other words, the client invokes methods on something 
that implements the remote interface. That something is the stub, of 
course, and since the stub is doing networking and I/O, all kinds of Bad 
Things can happen. The client has to acknowledge the risks by handling 
or declaring the remote exceptions. If the methods in an interface 
declare exceptions, any code calling methods on a reference of that type 
(the interface type) must handle or declare the exceptions. 



Y<~ 

aw0 T j'Jahod tails. An 

LU » w+. '.UaT gW 
o/ev- mtcrtaCes- 



import j ava . rmi . 



Remote interface is in java-'-"'' 1 



public interface MyRemote extends Remote 
public String sayHello() throws 



} 



{ 



RemoteException ; 



^ ''Every remote method dall is 
Considered 'risky'. Declaring 
oh cvcv-y 

method t omdcs -tKc t \ icht 
to fay attchtioh ahd 



Be sure arguments and return values are primitives or Serializable 

Arguments and return values of a remote method must be either primitive 
or Serializable. Think about it. Any argument to a remote method has to 
be packaged up and shipped across the network, and that’s done through 
Serialization. Same thing with return values. If you use primitives, Strings, 
and the majority of types in the API (including arrays and collections), 
you’ll be fine. If you are passing around your own types, just be sure that 
you make your classes implement Serializable. 



acknowledge that things 

hot v/ovk. 



public String sayHello() throws RemoteException; 

This ret um value is gonna be shipped 
over the wire fro. the server baek to 
the d.ent, SO it must be Serializable- 
I hats how args and return values get 
packaged up and sent- 3 
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remote deployment with RMI 



Step two: Make a Remote Implementation 

(?) Implement the Remote interface 




MyRemotelmpl.java 



Your service has to implement the remote interface — the one 
with the methods your client is going to call. 



public class MyRemotelmpl extends UnicastRemoteObject implements MyRemote { 



public String sayHello() — 
return "Server says, 'Hey'' 

} 

// more code in class 



S Th * will -»ake s«v e that 

You ve implemented all the methods 
£rom the ,»te«rfade you implement. |„ 
uiis 6dsc, -thcv-c s ohly ohe. 



(2) Extend UnicastRemoteObject 

In order to work as a remote service object, your object needs some 
functionality related to ‘being remote’. The simplest way is to extend 
UnicastRemoteObject (from the java. rmi. server package) and let that 
class (your superclass) do the work for you. 



public class MyRemotelmpl 



extends UnicastRemoteObject implements MyRemote { 



(3) Write a no-arg constructor that declares a RemoteException 

Your new superclass, UnicastRemoteObject, has one little problem — its 
constructor throws a RemoteException. The only way to deal with this is 
to declare a constructor for your remote implementation, just so that you 
have a place to declare the RemoteException. Remember, when a class is 
instantiated, its superclass constructor is always called. If your superclass 
constructor throws an exception, you have no choice but to declare that 



your constructor also throws an exception. 

public MyRemotelmpl () 



throws RemoteException { 



k/ -W ou don’t have * 



(4) Register the service with the RMI registry 

Now that you’ve got a remote service, you have to make it available to 
remote clients. You do this by instantiating it and putting it into the RMI 
registry (which must be running or this line of code fails) . When you 
register the implementation object, the RMI system actually puts the stub in 
the registry, since that’s what the client really needs. Register your service 
using the static rebind () method of the java. rmi. Naming class. 



try { 

MyRemote service = new MyRemotelmpl () ; 
Naming. rebind ("Remote Hello", service) , 
} catch (Exception ex) { . . . } 



(that tl'ients ta« 

listen 't 



4we r* ***** " a rltvv) and W 

to look it W? '» 5 U/T volA bind the 

»«■ w tk ' 



you are here ► 617 



Head First Java, 2nd Edition. Head First Java, 2nd Edition, ISBN: 0596009208 

Prepared for e.simons@icarin.fiuc.org, Eduard Simons 

Copyright © 2005 Bert Bates and Kathy Sierra. This PDF is made available for personal use only during the relevant subscription term, subject to the Safari Terms of Service. Any other use 
requires prior written consent from the copyright owner. Unauthorized use, reproduction and/or distribution are strictly prohibited and violate applicable laws. All rights reserved. 







stubs and skeletons 



Step three: generate stubs and skeletons 



(?) Run rmic on the remote implementation class 
(not the remote interface) 

The rmic tool, that comes with the Java software 
development kit, takes a service implementation and 
creates two new classes, the stub and the skeleton. 

It uses a naming convention that is the name of 
your remote implementation, with either _Stub or 
_Skeleton added to the end. There are other options 
with rmic, including not generating skeletons, 
seeing what the source code for these classes looked 
like, and even using HOP as the protocol. The way 
we’re doing it here is the way you’ll usually do it. 

The classes will land in the current directory (i.e. 
whatever you did a cd to). Remember, rmic must 
be able to see your implementation class, so you’ll 
probably run rmic from the directory where your 
remote implementation is. (We’re deliberately not 
using packages here, to make it simpler. In the Real 
World, you’ll need to account for package directory 
structures and fully-qualified names). 



Nofcte that 7°“ ^ ,*** "f'T 
the end- tlass 

I File Edit Window Help Whuffie 



f h hew 

disses for I he 
h «'P«r obj ed ^ 



s rmic MyRemotelmpl 



101101 P 
10 110 1 



MyRemotelmpLStub.class 



101101 P 
10 110 1 
0 11 0 
001 10 
001 01 



MyRemotelmpLSkel.class 



Step four: run rmiregistry 



(?) Bring up a terminal and start the rmiregistry. 

Be sure you start it from a directory that has access 
to your classes. The simplest way is to start it from 
your ‘classes’ directory. 



File Edit Window Help Huh? 



% rmiregistry 



Step five: start the service 



(?) Bring up another terminal and start your service 

This might be from a main() method in your remote 
implementation class, or from a separate launcher class. 
In this simple example, we put the starter code in the 
implementation class, in a main method that instantiates 
the object and registers it with RMI registry. 



File Edit Window Help Huh? 



%java MyRemotelmpl 
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remote deployment with RMI 



Complete code for the server side 

Server 



The Remote interface: 




import j ava . rmi . * ; 



m ^a«a«mjavar»>.?atkay 



-yW in-lev-face MUST extend 
public interface MyRemote extends Remote { jav3.vn'iR< n ' 0 t e 

All of Vou\r 'remo'te methods must 

public String sayHello() throws RemoteException ; declare a RemoteException 



The Remote service (the implementation): 



, tVe 



U.*\tas ^ e "'^foaikay c l e owct '« tbe 

easiest way to ™ake a 

public class MyRemotelmpl extends UnicastRemoteObject implements MyRemote { 

\ 



import j ava . rmi . * ; . 

import j ava . rmi . server . * ; 



public String sayHello ( ) { ^ 

return "Server says, 'Hey'' 



Vo* have to implement all the " ^ WST imp | eme „i v 

■n'fcerJf ate »*e-fchods, of toursc. Bu-t ^^oic \y\ic\rfs 6 cll 
*ohu that you do HOT have io 
declare the Rcv*oieB%te\>hoY\. 



public MyRemotelmpl () throws RemoteException { } 



public static void main ( String [] args) { 
try { 

MyRemote service = new MyRemotelmpl ( ) ; c 
Naming. rebind ("Remote Hello", service); 
} catch (Exception ex) { 
ex.printStackTrace () ; 



your superclass Constructor (for 
UnicastRemoteObject) declares an exception, so 
VOW must write a Constructor, because it mean 
that your constructor is Calling risky Code (its 
su^ev 6onS‘tv"u6‘toV") 



} 



Make ihc ircmoic obiedi. -th^^ V A* • 1 / 
^•ircais-t^y usiha ik+rJ-il-* k/ *kbe 

rame you renter it Waming,rebindO. The 



will 
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getting the stub 



How docs the client get the stub object? 



The client has to get the stub object, since that’s the thing the 
client will call methods on. And that’s where the RMI registry 
comes in. The client does a ‘lookup’, like going to the white pages 
of a phone book, and essentially says, “Here’s a name, and I’d like 
the stub that goes with that name.” 

lookupO is a s-tatid method o( 
the Naming dlass 

V 

MyRemote service = (MyRemote) Naming . lookup ("rmi : //127 .0.0. 1/Remote Hello") 



be ^ 

^- icewas 

sieved Uhdev- 






\ 

The dieni always uses -the 

: implementation as the 
fy? e f f he service. In -fact, 
the client never needs to know 
the actual class name of youv- 
vemote service. ' 



t 

\ ^ou have to dast it to the 
"mtev-'f ade, s'mde the lookup 
method returns type Objedt- 



7 [ 

your host name or 
address goes here 



IP 




Client 



RMI registry (on server) 



(T) Client does a lookup on the RMI registry 

Naming. lookup ("rmi : //127 . 0 . 0 . 1 /Remote Hello") ; 



(5) RMI registry returns the stub object 

(as the return value of the lookup method) and RMI 



deserializes the stub automatically. You MUST have 
the stub class (that rmic generated for you) on the 



client or the stub won’t be deserialized. 



(§) Client invokes a method on the stub, as 
though the stub IS the real service 

620 chapter 18 



Head First Java, 2nd Edition. Head First Java, 2nd Edition, ISBN: 0596009208 

Prepared for e.simons@icarin.fiuc.org, Eduard Simons 

Copyright © 2005 Bert Bates and Kathy Sierra. This PDF is made available for personal use only during the relevant subscription term, subject to the Safari Terms of Service. Any other use 
requires prior written consent from the copyright owner. Unauthorized use, reproduction and/or distribution are strictly prohibited and violate applicable laws. All rights reserved. 




remote deployment with RMI 



How docs the client get the stub class? 

Now we get to the interesting question. Somehow, someway, the 
client must have the stub class (that you generated earlier using 
rmic) at the time the client does the lookup, or else the stub won’t 
be deserialized on the client and the whole thing blows up. In a 
simple system, you can simply hand-deliver the stub class to the 
client. 

There’s a much cooler way, though, although it’s beyond the 
scope of this book. But just in case you’re interested, the cooler 
way is called “dynamic class downloading”. With dynamic class 
downloading, a stub object (or really any Serialized object) is 
‘stamped’ with a URL that tells the RMI system on the client 
where to find the class file for that object. Then, in the process of 
deserializing an object, if RMI can’t find the class locally, it uses 
that URL to do an HTTP Get to retrieve the class file. So you’d 
need a simple Web server to serve up class files, and you’d also 
need to change some security parameters on the client. There are 
a few other tricky issues with dynamic class downloading, but that’s 
the overview. 



Complete client code 

The Ma 

import j ava . rmi . * ; : 

J ava - package 

public class MyRemoteClient { 

public static void main (String [] args) { 
new MyRemoteClient ( ) .go() ; 






} 



public void go() { 



L r tve 

try { \4 ° 

MyRemote service = (MyRemote) Naming. lookup ("rmi :// 127 . 0 . 0 . 1/Remote Hello") 

T 

String s = service . sayHello ( ) ; you ^ ^ (p ^ 

\ o\r hosi^mc 

System. out .println (s) ; \ 

} catch (Exception ex) { jwt like a teaulav M 1l . 



and the name wed to 
bind/ rebind the semte 
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RMI class files 



Pe sure each machine has the class 
files it needs. 

The top three things programmers do wrong with RMI are: 

1 ) Forget to start rmiregistry before starting remote service 
(when you register the service using Naming.rebind(), the 
rmiregistry must be running!) 

2 ) Forget to make arguments and return types serializable 
(you won’t know until runtime; this is not something the 
compiler will detect.) 

3 ) Forget to give the stub class to the client. 



Don’t -Povgct, the dlient 
uses the mtev-fade to dal I 
methods on the stub. The 
dlient J\/M needs the stub 
dlass, but the dlient never 
v-e-Pers to the stub dlass 
in dode- The dlient always 
uses the remote inter-Pade, 
as though the remote 
inter-Pade I/VER6 the 
adtual remote objedt- 




Client.class MyRemotelmpLStub.class 



101101 P 
10 110 



TV* 






r 

^er£ atc 



MyRemote.class 



kt w 






101101 p 
10 110 1 

0 11 0 

001 10 
001 01 






101101 p 
10 no 1 
0 11 0 
001 10 
001 01 




MyRemotelmpl.class 


MyRemotelmpL 


Stub.class 



101101 P 
10 110 1 
0 11 0 
001 10 
001 01 



MyRemotelmpLSkel.class 

MyRemote.class 



101101 p 
10 no 1 

0 n o 

001 10 
001 01 



Server needs both the Stub and Skeleton 
dlasses, as well as the servide and the 
remote inter-Pade- It needs the stub dlass 
bedause remember, the stub is substituted 
-Por the real servide, when the real servide 
is bound to the RMl registry. 
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remote deployment with RMI 




Look at the sequence of events below, and 
place them in the order in which they 
occur in a Java RMI application. 



- J P 10 l 4. 

^^^themethod » the RMI registry | 



1 calUothesewei^^ 


1 on the stub J — 


5. 


I 1 He client does a looki 
j the RMI Reqistrv 


jL — The remote service is regis- 
i tered with the RMI registry 




The RMI registry is started 


The~remote service (remote 
implementation) is instantiated 1 




7. 







An object on one heap cannot get a normal Java 
reference to an object on a different heap (which means 
running on a different JVM) 

Java Remote Method Invocation (RMI) makes it seem like 
you’re calling a method on a remote object (i.e. an object 
in a different JVM), but you aren’t. 

When a client calls a method on a remote object, the 
client is really calling a method on a proxy of the remote 
object. The proxy is called a ‘stub’. 

A stub is a client helper object that takes care of the low- 
level networking details (sockets, streams, serialization, 
etc.) by packaging and sending method calls to the 
server. 

To build a remote service (in other words, an object that 
a remote client can ultimately call methods on), you must 
start with a remote interface. 

A remote interface must extend the java.rmi. Remote 
interface, and all methods must declare 
RemoteException. 

Your remote service implements your remote interface. 



■ Your remote service should extend UnicastRemoteObject. 
(Technically there are other ways to create a remote ob- 
ject, but extending UnicastRemoteObject is the simplest). 

■ Your remote service class must have a constructor, 
and the constructor must declare a RemoteException 
(because the superclass constructor declares one). 

■ Your remote service must be instantiated, and the object 
registered with the RMI registry. 

■ To register a remote service, use the static 
Naming. rebind(“Service Name”, servicelnstance); 

■ The RMI registry must be running on the same machine 
as the remote service, before you try to register a remote 
object with the RMI registry. 

■ The client looks up your remote service using the static 
Naming. lookup(“rmi://MyHostName/ServiceName”); 

■ Almost everything related to RMI can throw a 
RemoteException (checked by the compiler). This 
includes registering or looking up a service in the reigstry, 
and all remote method calls from the client to the stub. 
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uses for RMI 



Yeah, but who really uses RMI? 
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remote deployment with RMI 



Executable 

Jar 



100% Local 



□H 55 ! |5- 



Web Start 



RMI app 



Combination 



HTTP 



Servlets 



100% Remote 



What about Servlets? 

Servlets are Java programs that run on (and with) an HTTP web server. When a client uses a 
web browser to interact with a web page, a request is sent back to the web server. If the request 
needs the help of a Java servlet, the web server runs (or calls, if the servlet is already running) 
the servlet code. Servlet code is simply code that runs on the server, to do work as a result of 
whatever the client requests (for example, save information to a text hie or database on the 
server) . If you’re familiar with CGI scripts written in Perl, you know exactly what we’re talking 
about. Web developers use CGI scripts or servlets to do everything from sending user-submitted 
info to a database, to running a web-site’s discussion board. 

And even servlets can use RMI! 

By far, the most common use of J 2 EE technology is to mix servlets and EJBs together, where 
servlets are the client of the EJB. And in that case, the servlet is using RMI to talk to the EJBs. 

(A 1 though the way you use RMI with EJB is a little different from the process we just looked at.) 



0 Client fills out a registration form and clicks 'submit'. 

The HTTP server (i.e. web server) gets the request, sees that 
it's for a servlet, and sends the request to the servlet. 



Web Browser 



Web Server 




0 Servlet (Java code) runs, adds data to the database, 

composes a web page (with custom info) and sends it back to 
the client where it displays in the browser. 

x*. . o _ Web Server 
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very simple servlet 



Step for making and running a servlet 



(?) Find out where your servlets need to be placed. 

For these examples, we’ll assume that you already have a web server 
up and running, and that it’s already configured to support servlets. 
The most important thing is to find out exactly where your servlet 
class files have to be placed in order for your server to ‘see’ them. If 
you have a web site hosted by an ISP, the hosting service can tell you 
where to put your servlets, just as they’ll tell you where to place your 
CGI scripts. 



Web Server 




(5) Get the servlets. jar and add it to your classpath 

Servlets aren’t part of the standard Java libraries; you need 
the servlets classes packaged into the servlets .jar file. You can 
download the servlets classes fromjava.sun.com, or you can get 
them from your Java-enabled web server (like Apache Tomcat, at 
the apache.org site). Without these classes, you won’t be able to 
compile your servlets. 

(3) Write a servlet class by extending HttpServlet 

A servlet is just a Java class that extends HttpServlet (from the 
javax.servlet.http package). There are other types of servlets you 
can make, but most of the time we care only about HttpServlet. 

public class MyServletA extends HttpServlet { . . . 



3 

servlets.jar 



101101 p 



MyServletA.class 



(4) Write an HTML page that invokes your servlet 

When the user clicks a link that references your servlet, the web < H ^ D > Y> 

server will find the servlet and invoke the appropriate method MyPage.html 

depending on the HTTP command (GET, POST, etc.) 

<a href=" servlets /MyServletA" >This is the most amazing servlet. </a> 



(5) Make your servlet and HTML page available to your server 

This is completely dependent on your web server (and more specifi- 
cally, on which version of Java Servlets that you’re using) . Your ISP 
may simply tell you to drop it into a “Servlets” directory on your 
web site. But if you’re using, say, the latest version of Tomcat, you’ll 
have a lot more work to do to get the servlet (and web page) into 
the right location. (We just happen to have a book on this too .) 
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A very simple Servlet 



remote deployment with RMI 



import j ava . io . * ; Resides '«>. vatkays J^T ^\Cen> separate^ 

import javax . servlet. * ; ^ Rew\e**V>ev> the u ^ avc to d ovm 0 

import j avax . servlet . http . * ; ^ sta^davd V»V)v3' r ' cs 

^ Most ^ov-mal* servlets will e*-lend 
public class MyServletA extends HttpServlet { tfttp£ev-vlet, t he* override one or 

mov-e methods. 

Override the dofcfcW -P>‘ se ,ver ealU ^s ^e^od, ha»di»J ‘ 

HTTP 0T ^TeU ,<Y? i a response (I W>- 



£ 






public void doGet (HttpServletRequest request, HttpServletResponse response) 

throws ServletException , IOException { 



} 



response . setContentType ("text/html" 



This tells the server (and browser) what ki«d of 
thins is doming badk -from the server as a reuslt of 
this servlet vunning. 

output stream to 



PrintWriter out = response. getWri ter (); 



. ftives us an outyuu 

‘ on &k out to the server. 



String message = "If you're reading this, it worked!' 



out . println ( "<HTMLXBODY>" ) ; 
out .println ("<H1>" + message + 
out. println ("</BODYX/HTML>") ; 
out . close () ; 



'</Hl>") 




. i l ' e An HT ML- pay! The pay 

What we write >s an Jt I batk to 

aets delivered throuj th ^ 

the browser, just 1 7 , , ^ existed 






HTML page with a link to this servlet <'•' “ — * 

to tnofler 
servlet 

<HTML> 

<BODY> 

<a href="servlets/MyServletA">This is an amazing servlet. </a> 
</BODY> 

</HTML> 



This an amazing servlet. 
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servlets and JSP 



■ Servlets are Java classes that run entirely on 
(and/or within) an HTTP (web) server. 

■ Servlets are useful for running code on the 
server as a result of client interaction with a 
web page. For example, if a client submits 
information in a web page form, the servlet can 
process the information, add it to a database, 
and send back a customized, confirmation 
response page. 

■ To compile a servlet, you need the servlet 
packages which are in the servlets.jar file. The 
servlet classes are not part of the Java standard 
libraries, so you need to download the servlets, 
jar from java.sun.com or get them from a servlet- 
capable web server. (Note: the Servlet library 

is included with the Java 2 Enterprise Edition 
(J2EE)) 

■ To run a servlet, you must have a web server 
capable of running servlets, such as the Tomcat 
server from apache.org. 

■ Your servlet must be placed in a location that’s 
specific to your particular web server, so you’ll 
need to find that out before you try to run your 
servlets. If you have a web site hosted by an ISP 
that supports servlets, the ISP will tell you which 
directory to place your servlets in. 

■ A typical servlet extends HttpServlet and 
overrides one or more servlet methods, such as 
doGet() ordoPost(). 

■ The web server starts the servlet and calls the 
appropriate method (doGet(), etc.) based on the 
client’s request. 

■ The servlet can send back a response by getting 
a PrintWriter output stream from the response 
parameter of the doGet() method. 

■ The servlet ‘writes’ out an HTML page, complete 
with tags). 



f^ereiarerio 

Dumb Questions 

% What's a JSP, and how does it relate to servlets? 

A- 

Jr \ m JSP stands for Java Server Pages. In the end, the web server 
turns a JSP into a servlet, but the difference between a servlet and 
a JSP is what YOU (the developer) actually create. With a servlet, 
you write a Java class that contains HTML in the output statements 
(if you're sending back an HTML page to the client). But with a 
JSP, it's the opposite — you write an HTML page that contains Java 
code! 

This gives you the ability to have dynamic web pages where you 
write the page as a normal HTML page, except you embed Java 
code (and other tags that "trigger" Java code at runtime) that 
gets processed at runtime. In other words, part of the page is 
customized at runtime when the Java code runs. 

The main benefit of JSP over regular servlets is that it's just a lot 
easier to write the HTML part of a servlet as a JSP page than to 
write HTML in the torturous print out statements in the servlet's 
response. Imagine a reasonably complex HTML page, and now 
imagine formatting it within println statements. Yikes! 

But for many applications, it isn't necessary to use JSPs because 
the servlet doesn't need to send a dynamic response, or the 
HTML is simple enough not to be such a big pain. And, there are 
still many web servers out there that support servlets but do not 
support JSPs, so you're stuck. 

Another benefit of JSPs is that you can separate the work by 
having the Java developers write the servlets and the web page 
developers write the JSPs. That's the promised benefit, anyway. 

In reality, there's still a Java learning curve (and a tag learning 
curve) for anyone writing a JSP, so to think that an HTML web page 
designer can bang out JSPs is not realistic. Well, not without tools. 
But that's the good news — authoring tools are starting to appear, 
that help web page designers create JSPs without writing the 
code from scratch. 



Is this all you're gonna say about servlets? After such a 
huge thing on RMI? 

A- 

Jr \ m Yes. RMI is part of the Java language, and all the classes for 
RMI are in the standard libraries. Servlets and JSPs are not part of 
the Java language; they're considered standard extensions. You 
can run RMI on any modern JVM, but Servlets and JSPs require a 
properly configured web server with a servlet "container" This is 
our way of saying, "it's beyond the scope of this book." But you can 
read much more in the lovely Head First Servlets & JSP. 
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Just for f uw, let's wake the Phrase-O-Matic 
work as a servlet 



remote deployment with RMI 



Now that we told you that we won’t 
say any more about servlets, we can’t 
resist servletizing (yes, we can verbify 
it) the Phrase-O-Matic from chapter 1 . 
A servlet is still just Java. And Java code 
can call Java code from other classes. 
So a servlet is free to call a method on 
the Phrase-O-Matic. All you have to do 
is drop the Phrase-O-Matic class into 
the same directory as your servlet, and 
you’re in business. (The Phrase-O- 
Matic code is on the next page) . 




import j ava . io . * ; 



import j avax . servlet . * ; 
import j avax . servlet . http . * ; 



public class KathyServlet extends HttpServlet { 

public void doGet (HttpServletRequest request, HttpServletResponse response) 

throws ServletException , IOException { 



String title = "PhraseOMatic has generated the following phrase."; 

response . setContentType ("text/html") ; 

PrintWriter out = response . getWri ter () ; 

/ i l £o\\ methods or\ 

out . println ( "<HTMLXHEADXTITLE>" ) ; See? Y« wr „ e Ve 

out.println("PhraseOmatic") ; another tlass- I* _th ,s n ’ U, 0( i o£ the 

out. println ("</TITLEX/HEADXBODY>") ; X +he static makerhvasew , 

out.println("<Hl>" + title + "</Hl>") ; )u pv,raseOMat>t tlass on 

out . println ( "<P>" + PhraseOMatic . makePhrase ( ) ) ; 

out . println ( "<PXa href=\"KathyServlet\">make another phrase</aX/p>") ; 
out. println ("</BODYX/HTML>") ; 

out . close ( ) ; 

} 

} 
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Phrase-O-Matic code 



Phrase-O-Matic code, servlet-friendly 

This is a slightly different version from the code in chapter one. In the 
original, we ran the entire thing in a main() method, and we had to rerun 
the program each time to generate a new phrase at the command-line. In this 
version, the code simply returns a String (with the phrase) when you invoke 
the static makePhrase() method. That way, you can call the method from any 
other code and get back a String with the randomly-composed phrase. 

Please note that these long String [] array assignments are a victim of word- 
processing here — don’t type in the hyphens! Just keep on typing and let your 
code editor do the wrapping. And whatever you do, don’t hit the return key in 
the middle of a String (i.e. something between double quotes). 



public class PhraseOMatic { 

public static String makePhrase ( ) { 

// make three sets of words to choose from 

String[] wordListOne = { "24/7" , "multi-Tier" , "30 , 000 foot" , "B-to-B" , "win-win" , "front- 
end" , "web-based" , "pervasive" , "smart" , "six-sigma" , "critical -path" , "dynamic" } ; 

String [] wordListTwo = {"empowered", "sticky", "valued-added" , "oriented", "centric", 
"distributed", "clustered", "branded" , "outside -the -box" , "positioned", "networked", "fo- 
cused", "leveraged", "aligned", "targeted", "shared", "cooperative", "accelerated"}; 

String [] wordListThree = {"process", "tipping point", "solution", "architecture", 
"core competency", "strategy", "mindshare" , "portal", "space", "vision", "paradigm", "mis- 
sion"} ; 

// find out how many words are in each list 
int oneLength = wordListOne . length; 
int twoLength = wordListTwo . length; 
int threeLength = wordListThree . length; 

// generate three random numbers, to pull random words from each list 

int randl = (int) (Math . random ( ) * oneLength) ; 

int rand2 = (int) (Math . random ( ) * twoLength); 

int rand3 = (int) (Math . random ( ) * threeLength) ; 

// now build a phrase 

String phrase = wordListOne [randl] + " " + wordListTwo [rand2] +""+ 
wordListThree [rand3] ; 

// now return it 

return ("What we need is a " + phrase) ; 

} 

} 
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remote deployment with RMI 



Enterprise JavaPeans: RMI on steroids 

RMI is great for writing and running remote services. But 
you wouldn’t run something like an Amazon or eBay on RMI 
alone. For a large, deadly serious, enterprise application, you 
need something more. You need something that can handle 
transactions, heavy concurrency issues (like a gazillion 
people are hitting your server at once to buy those organic 
dog kibbles), security (not just anyone should hit your 
payroll database), and data management. For that, you need 
an enterprise application server. 

In Java, that means a Java 2 Enterprise Edition (J 2 EE) server. 
AJ 2 EE server includes both a web server and an Enterprise 
JavaBeans(EJB) server, so that you can deploy an application 
that includes both servlets and EJBs. Like servlets, EJB is 
way beyond the scope of this book, and there’s no way to 
show “just a little” EJB example with code, but we will take 
a quick look at how it works. (For a much more detailed 
treatment of EJB, we can recommend the lively Head First 
EJB certification study guide.) 



An EjB server adds a bunch 
of services that you don’t get 
with straight RMI- Things 
life transactions, security, 
concurrency, database 
management, and networking, 

An E JB Server Steps into the 
middle of an RMI call and 
layers in all of the services. 
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a little Jini 



For oor final trick... a li 

We love Jini. We think Jini is pretty much the best thing in Java. If EJB is RMI 
on steroids (with a bunch of managers), Jini is RMI with wings. Pure Java bliss 
Like the EJB material, we can’t get into any of the Jini details here, but if you 
know RMI, you’re three-quarters of the way there. In terms of technology, 
anyway. In terms of mindset, it’s time to make a big leap. No, it’s time to fly. 

Jini uses RMI (although other protocols can be involved), but gives you a few 
key features including: 

Adaptive discovery 

Self-healing networks 

With RMI, remember, the client has to know the 
name and location of the remote service. The 
client code for the lookup includes the IP address or 
hostname of the remote service (because that’s where 
the RMI registry is running) and the logical name the 
service was registered under. 

But with Jini, the client has to know only one thing: the 
interface implemented by the service! That’s it. 

So how do you find things? The trick revolves around Jini lookup 
services. Jini lookup services are far more powerful and flexible than 
the RMI registry. For one thing, Jini lookup services announce themselves to the 
network, automatically. When a lookup service comes online, it sends a message (using IP 
multicast) out to the network saying, “I’m here, if anyone’s interested.” 

But that’s not all. Let’s say you (a client) come online after the lookup service has already 
announced itself, you can send a message to the entire network saying, “Are there any 
lookup services out there?” 

Except that you’re not really interested in the lookup service itself— you’re interested in 
the services that are registered with the lookup service. Things like RMI remote services, 
other serializable Java objects, and even devices such as printers, cameras, and coffee- 
makers. 





And here’s where it gets even more fun: when a service comes online, it will dynamically 
discover (and register itself with) any Jini lookup services on the network. When the 
service registers with the lookup service, the service sends a serialized object to be placed 
in the lookup service. That serialized object can be a stub to an RMI remote service, a 
driver for a networked device, or even the whole service itself that (once you get it from 
the lookup service) runs locally on your machine. And instead of registering by name, the 
service registers by the interface it implements. 

Once you (the client) have a reference to a lookup service, you can say to that lookup 
service, “Hey, do you have anything that implements ScientificCalculator?” At that point, 
the lookup service will check its list of registered interfaces, and assuming it finds a 
match, says back to you, ‘Yes I do have something that implements that interface. Here’s 
the serialized object the ScientificCalculator service registered with me.” 
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Adaptive discovery in action 



remote deployment with RMI 



(?) Jini lookup service is launched somewhere on the network, and 
announces itself using IP multicast. 
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adaptive discovery in Jini 



Adaptive discovery in action, continued... 

(3) A client on the network wants 
something that implements the 
ScientificCalculator interface. It has 
no idea where (or if) that thing exists. 




(4) The lookup service responds, since it does have something 
registered as a ScientificCalculator interface. 




another machine on the network 



machine on the network 
somewhere. . . 



another machine on the network 
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remote deployment with RMI 



Self-healing network in action 

^ A Jini Service has asked to register with the lookup service. The lookup 
service responds with a "lease". The newly-registered service must keep 
renewing the lease, or the lookup service assumes the service has gone 
offline. The lookup service wants always to present an accurate picture 
to the rest of the network about which services are available. 




The service goes offline (somebody shuts it down), so it fails to 
renew its lease with the lookup service. The lookup service drops it. 




machine on the network 
somewhere. . . 



another machine on the network 



another machine on the network 
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universal service project 



Final Project: the Universal Service browser 

We’re going to make something that isn’t Jini-enabled, but quite easily could be. 

It will give you the flavor and feeling of Jini, but using straight RMI. In fact the 
main difference between our application and a Jini application is how the service is 
discovered. Instead of the Jini lookup service, which automatically announces itself and 
lives anywhere on the network, we’re using the RMI registry which must be on the same 
machine as the remote service, and which does not announce itself automatically. 

And instead of our service registering itself automatically with the lookup service, we 
have to register it in the RMI registry (using Naming.rebind()). 

But once the client has found the service in the RMI registry, the rest of the application 
is almost identical to the way we’d do it in Jini. (The main thing missing is the lease that 
would let us have a self-healing network if any of the services go down.) 

The universal service browser is like a specialized web browser, except instead of HTML 
pages, the service browser downloads and displays interactive Java GUIs that we’re 
calling universal services. 




Choose a sev-vidc -(Vom -the 
list The RMI remote servide 
has a getServideLis-tO 
method that sends badk this 
list C servides. 

VVh en the user seledts one, 
the dlient asks -for the 
adtual servide (DideRolling, 
DayO'fThelA/eek, etd ) to 
be sent badk -from the RMl 
remote servide- 



r ssSw" 
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remote deployment with RMI 



How it works: 



(l) Client starts up and 
does a lookup on the 
RMI registry for 
the service called 
"ServiceServer", and 
gets back the stub. 




Service Browser 
(client) 



Server 



RMI registry (on server) 



Service 

Server 



(5) Client calls getServiceList() on the stub. The ServiceServer 
returns an array of services 




Server 



Service Browser 

(client) "g etServiceListO" 



(3) Client displays the list of services in a GUI 



Service Browser 
(client) 




Server 
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universal service browser 



How it works, continued... 



(4) User selects from the list, so client calls the getService() 
method on the remote service. The remote service returns a 
serialized object that is an actual service that will run inside 
the client browser. 




(5) Client calls the get£uiPanel() on the serialized service object it 
just got from the remote service. The GUI for that service is 
displayed inside the browser, and the user can interact with it 
locally. At this point, we don't need the remote service unless/until 
the user decides to select another service. 

Service Browser 



(client) 
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remote deployment with RMI 



The classes and interfaces: 



(l) interface ServiceServer implements Remote 

A regular old RMI remote interface for the remote service (the 
remote service has the method for getting the service list and 
returning a selected service). 



ServiceServer 

getServicesListf) 

getServicef) 



(5) class ServiceServerlmpI implements ServiceServer 

The actual RMI remote service (extends UnicastRemoteObject). 
Its job is to instantiate and store all the services (the things 
that will be shipped to the client), and register the server itself 
(ServiceServerlmpI) with the RMI registry. 



ServiceServerlmpI 

getServicesListf) 

getServicef) 



(3) class ServiceBrowser 

The client. It builds a very simple GUI , does a lookup in the RMI 
registry to get the ServiceServer stub, then calls a remote method on 
it to get the list of services to display in the GUI list. 



ServiceBrowser 

mainf) 



(4) interface Service 

This is the key to everything. This very simple interface has just one 
method, getGuiPanel(). Every service that gets shipped over to the 
client must implement this interface. This is what makes the whole thing 
UNIVERSAL! By implementing this interface, a service can come over 
even though the client has no idea what the actual class (or classes) 
are that make up that service. All the client knows is that whatever 
comes over, it implements the Service interface, so it MUST have a 
getGuiPanelQ method. 

The client gets a serialized object as a result of calling 
getService(selectedSvc) on the ServiceServer stub, and all the client 
says to that object is, "I don't know who or what you are, but I DO 
know that you implement the Service interface, so I know I can call 
getOuiPanelQ on you. And since getGuiPanel() returns a JPanel, I'll just 
slap it into the browser GUI and start interacting with it! 



Service 

getGuiPanelf) 




(5) class DiceService implements Service 

Got dice? If not, but you need some, use this service to roll anywhere 
from 1 to 6 virtual dice for you. 



/ DiceService 

/ getGuiPanelf) 



© 



© 



class MiniMusicService implements Service 

Remember that fabulous little 'music video' program from the first 
GUI Code Kitchen? We've turned it into a service , and you can play it 
over and over and over until your roommates finally leave. 

class DayOfTheWeekService implements Service 

\Nere you born on a Friday? Type in your birthday and find out. 



DayOfTheWeekService 

getGuiPanelf) 



MiniMusicService 

getGuiPanelf) 
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universal service code 



interface ServiceServer (the remote interface) 



import j ava . rmi . * ; 

public interface ServiceServer extends Remote { 

Object [] getServiceList () throws RemoteException; 

Service getService (Object serviceKey) throws RemoteException; 

} 






A " etv ' ods 



interface Service (what the GUI services implement) 

* oid c, e . ho „_, 



import j avax . swing . * ; 
import j ava . io . * ; 

public interface Service extends Serializable { 
public JPanel getGuiPanel ( ) ; 



S T' C ? have M ±™«sal 

"’•ter-fade e ^i e ^ c • . The 

*^Llly beiSalSbE* mW “ e ^ 

dipped ±r ,£es 9 e * 

'rcsul-t c .f li .j. , ‘; <ror * scv-vcv- 

sJS^9 9 e ^vid e 0 



as a 

Oh 
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remote deployment with RMI 



class ServiceServerlmpI (the remote implementation) 

import j ava . rmi . * ; 
import j ava . util . * ; 



public class ServiceServerlmpI extends UnicastRemoteOb ject implements ServiceServer { 



serviceList = new HashMapO ; 

serviceList .put ("Dice Rolling Service", new DiceService ( ) ) ; 
serviceList .put ("Day of the Week Service", new DayOfTheWeekService () ) ; 
ServiceList . put ( "Visual Music Ser - '*"' r* <»" _ Mi n i Mn s i r Sprvi pp n ) _• 



public Service getService (Ob ject serviceKey) throws RemoteException { 
Service theService = (Service) serviceLis - * - ffoWaorwi poKav) • 



public static void main (String [] args) { 
try { 

Naming . rebind ("ServiceServer" , new ServiceServerlmpI ( ) ) ; 
} catch (Exception ex) { 
ex.printStackTrace () ; 

} 

System. out .println ("Remote service is running"); 



import j ava . rmi . server . * ; 




HashMap serviceList; 




public ServiceServerlmpI () throws RemoteException { 



setUpServices () ; 

} 




.tier is tailed. 

(PiteSevV'te, 




private void setUpServices ( ) { 



public Object [] getServiceList () { 

System. out .println ("in remote") ; 
return serviceList . keySet ( ) . toAr] 



} 



} 




} 



return theService; 




} 



} 
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ServiceBrowser code 

class ServiceBrowser (the client) 

import j ava . awt . * ; 
import j avax . swing . * ; 
import j ava . rmi . * ; 
import j ava . awt . event . * ; 

public class ServiceBrowser { 

JPanel mainPanel; 

JComboBox serviceList; 

ServiceServer server; 



public void buildGUI ( ) { 

JFrame frame = new JFrame("RMI Browser") ; 
mainPanel = new JPanel (); 

frame tCOntfin^^^ w A ^ \ /Dav*/ , 1av*T PTTWTIPD m A -i \ • 



frame . getContentPane ( ) . add (BorderLayout . NORTH , serviceList) ; 

serviceList . addActionListener (new MyListListener ( ) ) ; 

frame . setSize (500 , 500) ; 
frame . setVisible (true) ; 



Object [] servic 



serviceList = n 




} 



void loadService (Object serviceSelection) { 
try { 

Service svc = server . getService (serviceSelection) ; 
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remote deployment with RMI 



Object [] getServicesList() { 
Object obj = null; 

Object [] services = null; 

try { 






, RMI ' ook ^’ V 



:t^e 



stub 



obj = Naming . lookup ("rmi : //127 .0.0. 1/ServiceServer") ; 



} 

catch (Exception ex) { 
ex . prints tackTrace ( ) ; 



> 

server = (ServiceServer) obj ; 



try { 



-the s-fcub 4-n h i 



services = server .getServiceList () ; 

} catch (Exception ex) { 
ex . prints tackTrace ( ) ; 

} 

return services; 



J ctScv-vidcLis-tO gives us -tbe array o( Objedts, 
bat we display in ibe JComboBo* -for tbe user to 
seledt -from. 



class MyListListener implements ActionListener { 
public void actionPerf ormed (ActionEvent ev) { 



Object selection = serviceList .getSelectedItem() 
loadService (selection) ; 



*ade a 



public static void main (String [] args) 
new ServiceBrowser ( ) .buildGUI() ; 



it y * 1 ^ ux 
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DiceService code 



class DiceService (a universal service, implements Service) 



import j avax . swing . * ; 
import j ava . awt . event . * ; 
import j ava . io . * ; 

public class DiceService implements Service { 

JLabel label; 

JComboBox numOfDice; 



public JPanel getGuiPanel ( ) { 

JPanel panel = new JPanel ( ) ; 

JButton button = new JButton ("Roll 'em! 
String[] choices = {"1", "2", "3", "4", "5"}; 
numOfDice = new JComboBox (choices) ; 
label = new JLabel ("dice values here") ; 
button . addActionListener (new RollEmListener ( ) ) 
panel .add (numOfDice) ; Here s -the 



eoo 



Dice Rolling Service 



3 



{ 3 M ( Roll 'em! } 5 26 



panel . add (button) ; 
panel . add (label) ; 
return panel; 



} 



public class RollEmListener implements ActionListener { 
public void actionPerf ormed (ActionEvent ev) { 

// roll the dice 
String diceOutput = ""; 

String selection = (String) numOf Dice . getSelectedl tem () ; 
int numOfDiceToRoll = Integer . parselnt (selection) ; 
for (int i = 0; i < numOfDiceToRoll; i++) { 

int r = (int) ( (Math . random ( ) * 6) + 1) ; 
diceOutput += (" " + r) ; 

} 

label . setText (diceOutput) ; 



CwS -f ft. 

ihis service is selec-fced a*d \ aA ^ ohna £a ^ wt>e ' 1 

wah-t ih -the ge-t^uiPanelO £a>> wlia ^ ,:v «' r you 



} 

} 




your pencil 



Think about ways to improve the DiceService. One 
suggestion: using what you learned in the GUI chapters, 
make the dice graphical. Use a rectangle, and draw the 
appropriate number of circles on each one, corresponding 
to the roll for that particular die. 
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remote deployment with RMI 



class MiniMusicService (a universal service, implements Service) 



import j avax . sound . midi . * ; 
import j ava . io . * ; 
import j avax . swing . * ; 
import j ava . awt . * ; 
import j ava . awt . event . * ; 



MyDrawPanel myPanel; 



public class MiniMusicService implements Service { . 

... A" * . 

does * 4*?' 1 u 

YtL&W 
fee 



public JPanel getGuiPanel () { 

JPanel mainPanel = new JPanel ( ) ; 
myPanel = new MyDrawPanel ( ) ; 
JButton playltButton = new JButton 
playltButton . addActionListener (new 
mainPanel . add (myPanel) ; 
mainPanel . add (playltButton) ; 
return mainPanel; 



("Play it") ; 
PlayltListener () ) ; 




} 



public class PlayltListener implements ActionListener { 
public void actionPerf ormed (ActionEvent ev) { 

try { 



This is all the musie stu« -fy-om the 
Code Ki-Uheh i h ehap-tev- IZ, so we 
woh t annotate it again here. 



Sequencer sequencer = MidiSystem. getSequencer () ; 
sequencer . open ( ) ; 



sequencer . addControllerEventListener (myPanel , new int[] {127}); 
Sequence seq = new Sequence ( Sequence . PPQ , 4) ; 

Track track = seq . createTrack ( ) ; 



for (int i = 0; i < 100; i+= 4) { 



int rNum = (int) ( (Math . random ( ) * 50) + 1) ; 

if (rNum < 38) { // so now only do it if num <38 (75% of the time) 

tr ack. add (makeEvent( 144,1, rNum, 100,i) ) ; 
track. add (makeEvent( 17 6,1,127,0,1) ) ; 
track. add (makeEvent( 12 8,1, rNum, 100, i + 2)); 

} 

} // end loop 

sequencer . setSequence (seq) ; 
sequencer . start () ; 
sequencer . setTempoInBPM ( 220) ; 

} catch (Exception ex) {ex .printStackTrace () ; } 

} // close actionperf ormed 
} // close inner class 
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MiniMusicService code 



class MiniMusicService, continued... 

public MidiEvent makeEvent ( int comd, int chan, int one, int two, int tick) { 
MidiEvent event = null ; 
try { 

ShortMessage a = new ShortMessage () ; 
a . setMessage (comd, chan, one, two); 
event = new MidiEvent (a, tick) ; 

} catch (Exception e) { } 
return event; 

} 



class MyDrawPanel extends JPanel implements ControllerEventListener { 

// only if we got an event do we want to paint 
boolean msg = false; 

public void controlChange (ShortMessage event) { 



public void pain tComponent (Graphics g) { 
if (msg) { 

Graphics2D g2 = (Graphics2D) g; 

int r = (int) (Math . random ( ) * 250) ; 
int gr = (int) (Math . random ( ) * 250) ; 
int b = (int) (Math . random ( ) * 250) ; 

g. setColor (new Color (r,gr,b) ) ; 

int ht = (int) ( (Math . random ( ) * 120) + 10); 
int width = (int) ( (Math . random ( ) * 120) + 10); 

int x = (int) ( (Math . random ( ) * 40) + 10); 
int y = (int) ( (Math . random ( ) * 40) + 10); 

g.fillRect (x,y ,ht, width) ; 
msg = false; 

} // close if 
} // close method 
} // close inner class 

} // close class 
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} 



public Dimension getPreferredSize () { 

return new Dimension (300,300); 



msg = true; 
repaint ( ) ; 
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remote deployment with RMI 



class DayOfTheWeekService (a universal service, implements Service) 



import j avax . swing . * ; 
import j ava . awt . event . * ; 
import j ava . awt . * ; 
import j ava . io . * ; 
import j ava . util . * ; 
import j ava . text . * ; 

public class DayOfTheWeekService implements Service { 



JLabel outputLabel; 
JComboBox month; 
JTextField day; 
JTextField year; 



T l. £ e vM'<« 









public JPanel getGuiPanel ( ) { 

JPanel panel = new JPanel () ; 

JButton button = new JButton("Do it!"); 

button . addActionListener (new DoItListener ( ) ) ; 

outputLabel = new JLabel ("date appears here") ; 

DateFormatSymbols dateStuff = new DateFormatSymbols ( ) 

month = new JComboBox (dateStuff . getMonths ()) ; 

day = new JTextField (8) ; 

year = new JTextField (8) ; 

JPanel inputPanel = new JPanel (new GridLayout ( 3 , 2 ) ) ; 

inputPanel . add (new JLabel ("Month") ) ; 

inputPanel . add (month) ; 

inputPanel . add (new JLabel ("Day") ) ; 

inputPanel . add (day) ; 

inputPanel . add (new JLabel ( "Year" ) ) ; 

inputPanel . add (year) ; 

panel . add (inputPanel) ; 

panel . add (button) ; 

panel . add (outputLabel) ; 

return panel; 




} 



public class DoItListener implements ActionListener { 
public void actionPerf ormed (ActionEvent ev) { 
int monthNum = month . getSelectedlndex ( ) ; 
int dayNum = Integer .parselnt (day. getText() ) ; 
int yearNum = Integer .parselnt (year .getText() ) 
Calendar c = Calendar .ge tins tance () ; 
c . set (Calendar . MONTH , monthNum) ; 
c . set (Calendar . DAY_OF_MONTH , dayNum) ; 
c . set (Calendar . YEAR , yearNum) ; 

Date date = c . getTime ( ) ; 

String dayOfWeek = (new SimpleDateFormat ("EEEE 
outputLabel . setText (dayOfWeek) ; 



. r . a vew>'*'<i e ' r 

J Vio'w «**>« 



) ) . format (date) ; 



} 



} 
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the end... sort of 




^ Wouldnt it be X 

dreamy if this were the end 
of the book? If there were no 
more bullet points or puzzles 
or code listings or anything else? 
| But that's probably just a 
^ fantasy... . 



Congratulations! 

You made it to tke end. 



Of course, there’s still the two appendices. 
And the index. 

And then there’s the web site... 

There’s no escape, really. 
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Appendix A: 

Final Code Kitcken 



e o o 



Cyber BeatBox 



Bass Drum g “ □ Z Z Z Z '3 Z Z Z & Z Z Z 
Closed Hi-Hat □□0ZZZ00GZ0ZZD00 
Open Hi -Hat □□□□□□□□□□□□□□□□ 

Acoustic Snare Z ZZZZZZZZZZZ Z Z Z Z 
Crash Cymbal □□□□□□□□□□□□□□□□ 
Hand Clap ZZZZZZZZZZZZZZZZ 
□□□□□□□□□□□□□□□□ 
□□□□□□□□□□□caaaa 
& z a z a z a z a z a z a □ a z 
□□□□□□□□□□□□□□□□ 

z. _ z _ a _ _ a a _ a _ _ _ 

□□□□□□□□□□□□□□□□ 
□□□□□□□□□□□□□□□a 

Low-mid Torn □□□□□□□□□□□□□□□□ 
High Agogo ZZZZZZZZZZZZZZZZ 

open Hi Congaz z z a a a z z z z z z a a a z 



c 


Start 


1 


( 


Stop 


) 


< 


Tempo 


Up 


( 


Tempo 


Down 


( 


sendlt 


J 



High Tom 
Hi Bongo 
Maracas 
Whistle 
Low Conga 
Cowbell 
Vi bras lap 



dance beat 



Andy: groove #2 
Chris: groove2 revised i 
Nigel: dance beat 



x/ 0 w 



“ser\d 



Finally, the complete version of the BeatBox! 

It connects to a simple MusicServer so tkat you can 
send and receive keat patterns with otker clients. 



* to'ssj a es t 

rtycrs. a £k L IT 

ihe ih J io 

9 ° es 
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final BeatBox code 



Final BeatBox client program 

Most of this code is the same as the code from the CodeKitchens in the previous 
chapters, so we don’t annotate the whole thing again. The new parts include: 

GUI - two new components are added for the text area that displays incoming 
messages (actually a scrolling list) and the text field. 

NETWORKING - just like the SimpleChatClient in this chapter, the BeatBox now 
connects to the server and gets an input and output stream. 

THREADS - again, just like the SimpleChatClient, we start a ‘reader’ class that 
keeps looking for incoming messages from the server. But instead of just text, the 
messages coming in include TWO objects: the String message and the serialized 
ArrayList (the thing that holds the state of all the checkboxes.) 



import 

import 

import 

import 

import 

import 

import 

import 



j ava . awt . * ; 
j avax . swing . * ; 
j ava . io . * ; 
j avax . sound . midi . * ; 
java . util . * ; 
j ava . awt . event . * ; 
j ava . net . * ; 
j avax . swing . event . * ; 



public class BeatBoxFinal { 



JFrame theFrame ; 

JPanel mainPanel; 

JList incomingList ; 

JTextField userMessage; 

ArrayList< JCheckBox> checkboxList ; 
int nextNum; 

Vector<String> listVector = new Vector<String> ( ) ; 

String userName; 

ObjectOutputStream out; 

ObjectlnputStream in; 

HashMap<String, boolean []> otherSeqsMap = new HashMap<String, boolean []>(); 



Sequencer sequencer; 
Sequence sequence ; 

Sequence mySequence = null; 
Track track ; 



String [] instrumentNames = {"Bass Drum" , "Closed Hi-Hat", "Open Hi-Hat" , "Acoustic 
Snare", "Crash Cymbal", "Hand Clap", "High Tom", "Hi Bongo", "Maracas", "Whistle", 
"Low Conga", "Cowbell", "Vibraslap" , "Low-mid Tom", "High Agogo", "Open Hi Conga"}; 

int [ ] instruments = {35,42,46,38,49,39,50,60,70,72,64,56,58,47,67,63}; 
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appendix A Final Code Kitchen 



public static void main (String [] args) { 

new BeatBoxFinal () . startup (args [0] ) ; // args[0] is your user ID/screen name 



Thread remote = new Thread (new RemoteReader () ) ; 
remote . start ( ) ; 

} catch (Exception ex) { 

System. out .println ("couldn' t connect - you'll have to play alone."); 

} 

setUpMidi ( ) ; 
buildGUI () ; 

} // close startup 

public void buildGUI ( ) { notWmJ y\W V>cvc 

theFrame = new JFrame ("Cyber BeatBox") ; 

BorderLayout layout = new BorderLayout ( ) ; 

JPanel background = new JPanel (layout) ; 

background . setBorder (BorderFactory . createEmptyBorder (10 ,10,10,10)) ; 

checkboxList = new ArrayList<JCheckBox> () ; 

Box buttonBox = new Box (BoxLayout . Y_AXIS) ; 

JButton start = new JButton ("Start") ; 

start . addActionListener (new MyStartListener ( ) ) ; 

buttonBox . add (start) ; 

JButton stop = new JButton ("Stop") ; 

stop . addActionListener (new MyStopListener () ) ; 

buttonBox. add (stop) ; 

JButton upTempo = new JButton ("Tempo Up") ; 
upTempo . addActionListener (new MyUpTempoListener () ) ; 
buttonBox . add (upTempo) ; 

JButton downTempo = new JButton ("Tempo Down") ; 
downTempo . addActionListener (new MyDownTempoListener () ) ; 
buttonBox . add (downTempo) ; 

JButton sendlt = new JButton ("sendlt") ; 
sendlt . addActionListener (new MySendListener ( ) ) ; 
buttonBox . add (sendlt) ; 

userMessage = new JTextField() ; 



public void startup (String name) { 



} 




// open connection to the server 



try { 

Socket sock = new Socket ("127 . 0 . 0 . 1" , 4242); 

out = new ObjectOutputStream(sock.getOutputStream() ) ; 

in = new ObjectInputStream(sock .get!nputStream() ) ; 
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final BeatBox code 



buttonBox . add (userMessage) ; 



incomingList = new JList(); 

incomingList . addListSelectionListener (new MyListSelectionListener () ) ; 
incomingList . setSelectionMode (ListSelectionModel . SINGLE_SELECTION) ; 
JScrollPane theList = new JScrollPane (incomingList) ; 
buttonBox . add ( theList) ; 

incomingList . setListData (listVector) ; // no data to start with 



Box nameBox = new Box (BoxLayout . Y_AXIS) ; 
for (int i = 0; i < 16; i++) { 

nameBox . add (new Label (instrumentNames [i] ) ) ; 

} 

background. add (BorderLayout. EAST, buttonBox) ; 
background. add (BorderLayout .WEST, nameBox) ; 

theFrame . getContentPane ( ) . add (background) ; 

GridLayout grid = new GridLayout (16 , 16) ; 

grid . setVgap ( 1 ) ; 

grid . setHgap (2 ) ; 

mainPanel = new JPanel (grid) ; 

background . add (BorderLayout . CENTER , mainPanel ) ; 



Just is a >we haven't 

beW This is Oft* ■ W 

wo*** a " e d ?K' 

Onlv instead O? a nonrral that 
wheve 70W jws-t L-00K at tbe 

me ssavs, in this a ? uo« ^ 

SeufcCT a message W tv.e l.st 
to load and flav tbe attached 
beat \>attcvv\. 



for (int i = 0 ; i < 256 ; i++) { 

JCheckBox c = new JCheckBox ( ) ; 1 / # , . 

c. setSelected( false) ; ° lh 9 c ' s c oh this page is hew 

checkboxList .add(c) ; 
mainPanel . add (c) ; 

} // end loop 



theFrame . setBounds ( 50 , 50 , 300 , 300 ) ; 

theFrame . pack ( ) ; 

theFrame . setVisible (true) ; 

} // close buildGUI 



piiblic void setUpMidi ( ) { 

try { 

sequencer = MidiSystem. getSequencer () ; 
sequencer . open ( ) ; 

sequence = new Sequence ( Sequence . PPQ , 4 ) ; 
track = sequence . createTrack ( ) ; 
sequencer . setTempoInBPM (120) ; 

} catch (Exception e) {e .printStackTrace () ; } 






} // close setUpMidi 
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appendix A Final Code Kitchen 



public void buildTrackAndStart () { 

ArrayList<Integer> trackList = null; // this will hold the instruments for each 
sequence. dele teTrack (track) ; 
track = sequence . createTrack ( ) ; 

for (int i = 0; i < 16; i++) { 

trackList = new ArrayList<Integer> ( ) ; 

for (int j = 0; j < 16; j++) { 

JCheckBox jc = (JCheckBox) checkboxList . get ( j + (16*i) ) ; 
if ( jc . isSelected() ) { 

int key = instruments [i] ; 
trackList . add (new Integer (key) ) ; 

} else { 

trackList . add (null) ; // because this slot should be empty in the track 




} // close inner loop 

makeTracks (trackList) ; 

} // close outer loop 

track . add (makeEvent (192 , 9 , 1 , 0 , 15) ) ; // - so we always go to full 16 beats 
try { 

sequencer . setSequence (sequence) ; 

sequencer . setLoopCount (sequencer . LOOP_CONTINUOUSLY) ; 

sequencer . start ( ) ; 

sequencer . setTempoInBPM( 120) ; 

} catch (Exception e) {e . printStackTrace ( ) ; } 

} // close method 



public class MyStartListener implements ActionListener { 
public void actionPerf ormed (ActionEvent a) { 
buildTrackAndStart () ; 

} // close actionPerf ormed 
} // close inner class 

public class MyStopListener implements ActionListener { 
public void actionPerf ormed (ActionEvent a) { 
sequencer . stop ( ) ; 

} // close actionPerf ormed 
} // close inner class 

public class MyUpTempoListener implements ActionListener { 
public void actionPerf ormed (ActionEvent a) { 

float tempoFactor = sequencer . getTempoFactor ( ) ; 
sequencer . setTempoFactor ( (float) (tempoFactor * 1.03)); 

} // close actionPerf ormed 
} // close inner class 
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final BeatBox code 



public class MyDownTempoListener implements ActionListener { 



public void actionPerf ormed (ActionEvent a) { 
float tempoFactor = sequencer . getTempoFactor ( ) ; 
sequencer . setTempoFactor ( (float) (tempoFactor * . 97) ) ; 



} 



} 



public class MySendListener implements ActionListener { 
public void actionPerf ormed (ActionEvent a) { 

// make an arraylist of just the STATE of the checkboxes 
boolean [] checkboxState = new boolean [256] ; 
for (int i = 0; i < 256; i++) { 



out . writeObject (userName + nextNum++ + ": " + userMessage . getText () ) ; 
out .writeObject (checkboxState) ; 

} catch (Exception ex) { 

System. out .pr in tin ("Sorry dude. Could not send it to the server.") ; 



userMessage . setText (" " ) ; 

} // close actionPerf ormed 
} // close inner class 

public class MyListSelectionListener implements ListSelectionListener { 
public void valueChanged (ListSelectionEvent le) { 
if ( ! le . ge tValue I sAd justing ( ) ) { 



String selected = (String) incomingList . getSelectedValue ( ) ; 
if (selected != null) { 

// now go to the map, and change the sequence 
boolean [] selectedState = (boolean []) otherSeqsMap . get (selected) ; 
changeSequence (selectedState) ; 
sequencer . stop () ; 
buildTrackAndStart () ; 



} // close loop 

String messageToSend = null; 
try { 



checkboxState [i] = true; 

} 



JCheckBox check = (JCheckBox) c] 



if (check. isSelected() ) { 




} 



} 

} 

} // close valueChanged 
} // close inner class 
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appendix A Final Code Kitchen 



public class RemoteReader implements Runnable { 
boolean [] checkboxState = null; 

String nameToShow = null; 

Object obj = null; 
public void run() { 
try { 

while ( (obj =in. readObject () ) != null) { 

System. out. println ("got an object from servi 
System . out . println (obj . getClass ( ) ) ; 

String nameToShow = (String) obj ; 
checkboxState = (boolean []) in. readObject () 
otherSeqsMap . put (nameToShow , checkboxState) 
listVector. add (nameToShow) ; 
incomingList . setListData (listVector) ; 

} // close while 

} catch (Exception ex) {ex .printStackTrace () ; } 

} // close run 
} // close inner class 



, data 






Wo. , 






(des «ria ii^)^ >h, 

: Ue JL «t 






JL,u 7 ™+ay. Lisi) 7T “ * old. 

U w Jl * e Mai Vut d ihe » i'll i hf 

public class MyPlayMineListener implements ActionListener { ^ to display j 0lr 5 ii*s s c 

public void actionPerf ormed (ActionEvent a) { ' ^ c lis ■£. 



if (mySequence != null) { 
sequence = mySequence; 



// restore to my original 



} // close actionPerf ormed 
} // close inner class 

public void changeSequence (boolean [ ] 
for (int i = 0; i < 256; i++) { 

JCheckBox check = (JCheckBox) checkboxList . get (i) ; 
if (checkboxState [i] ) { 

check. setSelected( true) ; 

} else { 

check. setSelected( false) ; 



checkboxSta^»9P the patter io the o^Sey^Lttd 



} 

} // close loop 
} // close changeSequence 



All the MIDI st*« ■* same as * 

was m the pveviows version. 



public void makeTracks (ArrayList list) { 

Iterator it = list . iterator () ; 
for (int i = 0; i < 16; i++) { 

Integer num = (Integer) it.next(); 
if (num != null) { 

int numKey = num . intValue ( ) ; 

track . add (makeEvent (144 , 9 ,numKey , 100, i) ) ; 

track . add (makeEvent (128 , 9 , numKey , 100 , i + 1) ) ; 

} 

} // close loop 
} // close makeTracks () 
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final BeatBox code 



public MidiEvent makeEvent ( int comd, int chan, int one, int two, int tick) { 
MidiEvent event = null ; 
try { 

ShortMessage a = new ShortMessage () ; 
a. setMessage (comd, chan, one, two); 
event = new MidiEvent (a, tick) ; 

} catch (Exception e) { } 1 XVe. -fc,V>e ' as ^ ' teri ' or " 

return event; k/J-WhA »'«'*'• ' * 

} // close makeEvent 






} // close class 




your pencil 



What are some of the ways you can improve this program? 

Here are a few ideas to get you started: 

1 ) Once you select a pattern, whatever current pattern was playing is blown 
away. If that was a new pattern you were working on (or a modification of 
another one), you're out of luck. You might want to pop up a dialog box that 
asks the user if he'd like to save the current pattern. 



2) If you fail to type in a command-line argument, you just get an exception 
when you run it! Put something in the main method that checks to see if 
you've passed in a command-line argument. If the user doesn't supply one, 
either pick a default or print out a message that says they need to run it 
again, but this time with an argument for their screen name. 



3) It might be nice to have a feature where you can click a button and it 
will generate a random pattern for you. You might hit on one you really like. 
Better yet, have another feature that lets you load in existing 'foundation' 
patterns, like one for jazz, rock, reggae, etc. that the user can add to. 

You can find existing patterns on the Head First Java web start. 
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appendix A Final Code Kitchen 



Final BeatBox server program 

Most of this code is identical to the SimpleChatServer we made in the 
Networking and Threads chapter. The only difference, in fact, is that this server 
receives, and then re-sends, two serialized objects instead of a plain String 
(although one of the serialized objects happens to be a String). 



import j ava . io . * ; 
import j ava . net . * ; 
import j ava . util . * ; 

public class MusicServer { 

ArrayList<Ob jectOutputStream> cl ientOutputStr earns ; 

public static void main (String [] args) { 
new MusicServer () .go() ; 

} 

public class ClientHandler implements Runnable { 

ObjectlnputStream in; 

Socket clientSocket; 

public ClientHandler (Socket socket) { 
try { 

clientSocket = socket; 

in = new Obj ectlnputStream ( clientSocket .getInputStream() ) ; 

} catch (Exception ex) {ex .printStackTrace () ; } 

} // close constructor 



public void run() { 

Object o2 = null; 

Object ol = null; 
try { 

while ( (ol = in.readObject () ) != null) { 

o2 = in. readObject () ; 

System. out .pr in tin ("read two objects"); 
tellEveryone (ol , o2) ; 

} // close while 

} catch (Exception ex) {ex .printStackTrace (); } 

} // close run 

} // close inner class 
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final BeatBox code 



public void go() { 

clientOutputStreams = new ArrayList<ObjectOutputStream> () ; 
try { 

ServerSocket serverSock = new ServerSocket (4242) ; 
while (true) { 

Socket clientSocket = serverSock . accept ( ) ; 

ObjectOutputStream out = new ObjectOutputStream(clientSocket.getOutputStream() ) ; 
clientOutputStreams . add (out) ; 

Thread t = new Thread (new ClientHandler (clientSocket) ) ; 
t . start () ; 

System. out .println ("got a connection") ; 

} 

} catch (Exception ex) { 
ex . printStackTrace ( ) ; 

} 

} // close go 

public void tellEveryone (Object one. Object two) { 

Iterator it = clientOutputStreams . iterator () ; 
while (it .hasNext () ) { 

try { 

ObjectOutputStream out = (ObjectOutputStream) it. next () ; 
out . writeObject (one) ; 
out . writeObject (two) ; 

} catch (Exception ex) { ex . printStackTrace ( ) ; } 

} 

} // close tellEveryone 
} // close class 
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Appendix B 

The Top Ten Topics that almost made it into the Real Book... 




We covered a lot of ground, and you're almost finished with this book. We'll miss you, but before 
we let you go, we wouldn't feel right about sending you out into JavaLand without a little more 
preparation. We can't possibly fit everything you'll need to know into this relatively small appendix. 
Actually, we did originally include everything you need to know about Java (not already covered by 
the other chapters), by reducing the type point size to .00003. It all fit, but nobody could read it. So, 
we threw most of it away, but kept the best bits for this Top Ten appendix. 

This really is the end of the book. Except for the index (a must-read!). 
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bit manipulation 



#10 Bit Manipulation 

Why do you care? 

We’ve talked about the fact that there are 8 bits in a byte, 

16 bits in a short, and so on. You might have occasion to 
turn individual bits on or off. For instance you might find 
yourself writing code for your new Java enabled toaster, 
and realize that due to severe memory limitations, certain 
toaster settings are controlled at the bit level. For easier 
reading, we’re showing only the last 8 bits in the comments 
rather than the full 32 for an int) . 

Bitwise NOT Operator: ~ 

This operator ‘flips all the bits’ of a primitive. 

int x = 10; // bits are 00001010 

x = ~x; // bits are now 11110101 

The next three operators compare two primitives on a bit 
by bit basis, and return a result based on comparing these 
bits. We’ll use the following example for the next three 
operators: 



int x = 10; // bits are 00001010 

int y = 6; // bits are 00000110 

Bitwise AND Operator: & 

This operator returns a value whose bits are turned on only 
if both original bits are turned on: 

int a = x & y; // bits are 00000010 

Bitwise OR Operator: | 

This operator returns a value whose bits are turned on only 
if either of the original bits are turned on: 

int a = x | y; // bits are 00001110 

Bitwise XOR (exclusive OR) Operator: A 

This operator returns a value whose bits are turned on only 
if exactly one of the original bits are turned on: 

int a = x A y; // bits are 00001100 
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The Shift Operators 

These operators take a single integer primitive and shift (or 
slide) all of its bits in one direction or another. If you want 
to dust off your binary math skills, you might realize that 
shifting bits left effectively multiplies a number by a power of 
two, and shifting bits right effectively divides a number by a 
power of two. 

We’ll use the following example for the next three operators: 

int x = -11; // bits are 11110101 

Ok, ok, we’ve been putting it off, here is the world’s 
shortest explanation of storing negative numbers, and 
two’s complement. Remember, the leftmost bit of an integer 
number is called the sign bit. A negative integer number in 
Java always has its sign bit turned on (i.e. set to 1). A positive 
integer number always has its sign bit turned off ( 0). Java 
uses the two’s complement formula to store negative numbers. 
To change a number’s sign using two’s complement, flip all 
the bits, then add 1 (with a byte, for example, that would 
mean adding 00000001 to the flipped value). 

Right Shift Operator: » 

This operator shifts all of a number’s bits right by a certain 
number, and fills all of the bits on the left side with whatever 
the original leftmost bit was. The sign bit does not change: 

int y = x >> 2; // bits are 11111101 

Unsigned Right Shift Operator: »> 

Just like the right shift operator BUT it ALWAYS fills the 
leftmost bits with zeros. The sign bit might change: 



int y = x >>> 2; // bits are 00111101 

Left Shift Operator: « 

Just like the unsigned right shift operator, but in the other 
direction; the rightmost bits are filled with zeros. The sign bit 
might change. 

int y = x << 2; // bits are 11010100 
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#9 Immutability 

Why do you care that Strings are Immutable? 

When your Java programs start to get big, you’ll 
inevitably end up with lots and lots of String objects. 
For security purposes, and for the sake of conserving 
memory (remember your Java programs can run on 
teeny Java-enabled cell phones), Strings in Java are 
immutable. What this means is that when you say: 

String s = "0"; 

for (int x = 1; x < 10; x++) { 
s = s + x; 

} 

What’s actually happening is that you’re creating ten 
String objects (with values “0”, “01”, “012”, through 
“0123456789”) . In the end 5 is referring to the String 
with the value “0123456789”, but at this point there 
are ten Strings in existence ! 

Whenever you make a new String, the JVM puts it 
into a special part of memory called the ‘String Pool’ 
(sounds refreshing doesn’t it?). If there is already 
a String in the String Pool with the same value, the 
JVM doesn’t create a duplicate, it simply refers your 
reference variable to the existing entry. The JVM can 
get away with this because Strings are immutable; one 
reference variable can’t change a String’s value out 
from under another reference variable referring to 
the same String. 

The other issue with the String pool is that the 
Garbage Collector doesn’t go there. So in our example, 
unless by coincidence you later happen to make a 
String called “01234”, for instance, the first nine 
Strings created in our for loop will just sit around 
wasting memory. 

How does this save memory? 

Well, if you’re not careful, it doesn’tl But if you un- 
derstand how String immutability works, than you 
can sometimes take advantage of it to save memory. 

If you have to do a lot of String manipulations (like 
concatenations, etc.), however, there is another class 
StringBuilder, better suited for that purpose. We’ll 
talk more about StringBuilder in a few pages. 



Why do you care that Wrappers are 
Immutable? 

In the Math chapter we talked about the two main 
uses of the wrapper classes: 

• Wrapping a primitive so it can pretend to be an 
object. 

• Using the static utility methods (for example, 
Integer.parselnt() ) . 

It’s important to remember that when you create a 
wrapper object like: 

Integer iWrap = new Integer (42); 

That’s it for that wrapper object. Its value will always 
be 42. There is no setter method for a wrapper object. 
You can, of course, refer iWrap to a different wrapper 
object, but then you’ll have two objects. Once you 
create a wrapper object, there’s no way to change 
the value of that object! 
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#8 Assertions 

We haven’t talked much about how to debug your Java 
program while you’re developing it. We believe that 
you should learn Java at the command line, as we’ve 
been doing throughout the book. Once you’re a Java 
pro, if you decide to use an IDE*, you might have 
other debugging tools to use. In the old days, when 
a Java programmer wanted to debug her code, she’d 
stick a bunch of Sys tern. out. println( ) statements 
throughout the program, printing current variable 
values, and “I got here” messages, to see if the flow 
control was working properly. (The ready-bake code 
in chapter 6 left some debugging ‘print’ statements 
in the code.) Then, once the program was working 
correctly, she’d go through and take all those System. 
out.println( ) statements back out again. It was 
tedious and error prone. But as of Java 1.4 (and 5 . 0 ), 
debugging got a whole lot easier. The answer? 

Assertions 

Assertions are like Sys tern. out. prin tin ( ) statements 
on steroids. Add them to your code as you would 
add println statements. The Java 5.0 compiler 
assumes you’ll be compiling source hies that are 5.0 
compatible, so as of Java 5 . 0 , compiling with assertions 
is enabled by default. 

At runtime, if you do nothing, the assert statements 
you added to your code will be ignored by the JVM, 
and won’t slow down your program. But if you tell the 
JVM to enable your assertions, they will help you do 
your debugging, without changing a line of code! 

Some folks have complained about having to leave 
assert statements in their production code, but 
leaving them in can be really valuable when your 
code is already deployed in the held. If your client 
is having trouble, you can instruct the client to run 
the program with assertions enabled, and have the 
client send you the output. If the assertions were 
stripped out of your deployed code, you’d never 
have that option. And there is almost no downside; 
when assertions are not enabled, they are completely 
ignored by the JVM, so there’s no performance hit to 
worry about. 



How to make Assertions work 

Add assertion statements to your code wherever you 
believe that something must be true. For instance: 

assert (height > 0) ; 

// if true, program continues normally 
// if false, throw an AssertionError 

You can add a little more information to the stack 
trace by saying: 

assert (height >0) : "height = " + 

height + " weight = " + weight; 

The expression after the colon can be any legal 
Java expression that resolves to a non-null value. But 
whatever you do, don't create assertions that change an 
object’s state! If you do, enabling assertions at runtime 
might change how your program performs. 

Compiling and running with 
Assertions 

To compile with assertions: 

javac TestDriveGame . j ava 

(Notice that no command line options were 
necessary.) 

To run with assertions: 
java -ea TestDriveGame 



* IDE stands for Integrated Development Environment 
and includes tools such as Eclipse, Borland’s JBuilder, or 
the open source NetBeans (netbeans.org) . 
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#7 Block Scope 



In chapter 9 , we talked about how local variables 
live only as long as the method in which they’re 
declared stays on the stack. But some variables can 
have even shorter lifespans. Inside of methods, we 
often create blocks of code. We’ve been doing this 
all along, but we haven’t explicitly talked in terms of 
blocks. Typically, blocks of code occur within methods, 
and are bounded by curly braces { }. Some common 
examples of code blocks that you’ll recognize include 
loops (for, while) and conditional expressions (like if 
statements) . 



1 1 j ^q\qC,V- 

Let’s look at an example: ° 

void doStuff ( ) { , I i \ . cv vtiY-e w'C'thod 

liable to the wv 



for(int y = 0; y < 5; y++) { 




of a U loo? 

stored to oA'j tVi« W 



block, and y * 
loop! 






X = X + y; -Ko V vo W Cand 7 -^ 1 n,o ?e 

eirvd o( the -for loop blodk 



} 



nf • do*pi| C / y is ou ± ^ K 

the way ,i Works i„ sorB( . 0 ^ et . 



end of the method block, now x is also owt of scope 



(this is hot 
bewdve.O 



In the previous example, y was a block variable, 
declared inside a block, and y went out of scope as 
soon as the for loop ended. Your Java programs will 
be more debuggable and expandable if you use local 
variables instead of instance variables, and block 
variables instead of local variables, whenever possible. 
The compiler will make sure that you don’t try to use 
a variable that’s gone out of scope, so you don’t have 
to worry about runtime meltdowns. 
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#6 Linked Invocations 

While you did see a little of this in this book, we tried to keep our syntax as clean and 
readable as possible. There are, however, many legal shortcuts in Java, that you’ll no doubt 
be exposed to, especially if you have to read a lot code you didn’t write. One of the more 
common constructs you will encounter is known as linked invocations. For example: 

StringBuffer sb = new StringBuff er ( "spring" ) ; 

sb = sb.delete (3, 6) . insert (2, "umme") .deleteCharAt (1) ; 

System. out .println ("sb = " + sb) ; 

// result is sb = summer 

What in the world is happening in the second line of code? Admittedly, this is a contrived 
example, but you need to learn how to decipher these. 

1 - Work from left to right. 

2 - Find the result of the leftmost method call, in this case sb.delete (3 , 6). If you 
look up StringBuffer in the API docs, you’ll see that the delete ( ) method returns a 
StringBuffer object. The result of running the delete ( ) method is a StringBuffer object 
with the value “spr”. 

3 - The next leftmost method (insert())is called on the newly created StringBuffer 
object “spr”. The result of that method call (the insert ( ) method), is also a StringBuffer 
object (although it doesn’t have to be the same type as the previous method return), and so 
it goes, the returned object is used to call the next method to the right. In theory, you can 
link as many methods as you want in a single statement (although it’s rare to see more than 
three linked methods in a single statement) . Without linking, the second line of code from 
above would be more readable, and look something like this: 

sb = sb . delete (3, 6) ; 
sb = sb . insert (2 , "umme" ) ; 
sb = sb . deleteCharAt ( 1 ) ; 

But here’s a more common, and useful example, that you saw us using, but we thought 
we’d point it out again here. This is for when your main() method needs to invoke an 
instance method of the main class, but you don’t need to keep a reference to the instance of 
the class. In other words, the main() needs to create the instance only so that main() can 
invoke one of the instance’s methods. 

class Foo { 



public static void main (Strina M aras) T 
new 




void go ( ) 



oid go ( ) { tViene'Nt*’ 

// here's what we REALLY want.. 
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#5 Anonymous and Static Nested Classes 



Nested classes come in many flavors 

In the GUI event-handling section of the book, we started using inner (nested) classes as a 
solution for implementing listener interfaces. That’s the most common, practical, and read- 
able form of an inner class — where the class is simply nested within the curly braces of another 
enclosing class. And remember, it means you need an instance of the outer class in order to get 
an instance of the inner class, because the inner class is a member of the outer/enclosing class. 

But there are other kinds of inner classes including static and anonymous. We’re not going 
into the details here, but we don’t want you to be thrown by strange syntax when you see it in 
someone’s code. Because out of virtually anything you can do with the Java language, perhaps 
nothing produces more bizarre-looking code than anonymous inner classes. But we’ll start with 
something simpler — static nested classes. 

Static nested classes 

You already know what static means — something tied to the class, not a particular instance. A 
static nested class looks just like the non-static classes we used for event listeners, except they’re 
marked with the keyword static. 



public class FooOuter { 



static class Barlnner { 



A sUU tla “ ,s -V/ /A 3 



void saylt() { 

System. out .pr in tin ("method of a static inner class") ; 

} 




} 



} 

Static nested classes are more like regular non-nested classes in that they don’t enjoy a special relation- 
ship with an enclosing outer object. But because static nested classes are still considered a member of 
the enclosing/ outer class, they still get access to any private members of the outer class... but only the 
ones that are also static. Since the static nested class isn’t connected to an instance of the outer class, it 
doesn’t have any special way to access the non-static (instance) variables and methods. 
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#5 Anonymous and Static Nested Classes, continued 



The difference between nested and inner 

Any Java class that’s defined within the scope of another class is known as a nested class. It 
doesn’t matter if it’s anonymous, static, normal, whatever. If it’s inside another class, it’s 
technically considered a nested class. But non-static nested classes are often referred to as inner 
classes, which is what we called them earlier in the book. The bottom line: all inner classes are 
nested classes, but not all nested classes are inner classes. 

Anonymous inner classes 

Imagine you’re writing some GUI code, and suddenly realize that you need an instance 
of a class that implements ActionListener. But you realize you don’t have an instance of an 
ActionListener. Then you realize that you also never wrote a class for that listener. You have two 
choices at that point: 

1) Write an inner class in your code, the way we did in our GUI code, and then instantiate it 
and pass that instance into the button’s event registration (addActionListener()) method. 



2) Create an anonymous inner class and instantiate it, right there, just-in-time. Literally right 
where you are at the point you need the listener object. That’s right, you create the class and the 
instance in the place where you’d normally be supplying just the instance. Think about that for 
a moment — it means you pass the entire class where you’d normally pass only an instance into a 
method argument! 



OR 



import j ava . awt . event . * ; 
import j avax . swing . * ; 
public class TestAnon { 







public static void main (String [] args) { 



JFrame frame = new JFrame ( ) ; 

JButton button = new JButton ("click") ; 
frame . getContentPane ( ) . add (button) ; 

// button . addActionListener (quitListener ) ; 




TWis sta-te^e^ 



button . addActionListener (new ActionListener ( ) { 



* button . 

/ publi 



public void actionPerfo (ActionEvent ev) { 



System. exit (0) ; 

} 
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#4 Access Levels and Access Modifiers (Who Sees What) 



Java has four access levels and three access modifiers. There are only modifiers because 
the default (what you get when you don’t use any access modifier) is one of the four 
access levels. 



Access Levels (in order of how restrictive they are, from least to most restrictive) 



public ^ public. means any todt any where dan addess the public. thing (by 

thing we mean dlass, variable, method, donstv-udtor, etd ). 



protected V pv-otedted works just like de-fault (dode in the same padkage has addess), EXCEPT it 

also allows subdlasses outside the padkage to inherit the protedted thing. 



default 

private 



de-fault addess means that only dode within the same padkage as 
the dlass with the de-fault thing dan addess the de-fault thing. 

private means that only dode within the same dlass dan addess the private thing. 
J^eep in mind it means private to the dlass, not private to the objedt- One Dog 
dan see another Dog objedt^ private stu-f-f, but a Cat dan’t see a Dog s privates. 



Access modifiers 



public 

protected 

private 



Most of the time you’ll use only public and private access levels. 

public 

Use public for classes, constants (static final variables), and methods that you’re 
exposing to other code (for example getters and setters) and most constructors. 

private 

Use private for virtually all instance variables, and for methods that you don’t want 
outside code to call (in other words, methods used by the public methods of your class) . 

But although you might not use the other two (protected and default), you still need to 
know what they do because you’ll see them in other code. 
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#4 Access Levels and Access Modifiers, cont. 

default and protected 

default 

Both protected and default access levels are tied to packages. Default access is simple — it 
means that only code within the same package can access code with default access. So a 
default class, for example (which means a class that isn’t explicitly declared as public ) can 
be accessed by only classes within the same package as the default class. 

But what does it really mean to access a class? Code that does not have access to a class is 
not allowed to even think about the class. And by think, we mean use the class in code. 

For example, if you don’t have access to a class, because of access restriction, you aren’t 
allowed to instantiate the class or even declare it as a type for a variable, argument, or 
return value. You simply can’t type it into your code at all! If you do, the compiler will 
complain. 

Think about the implications — a default class with public methods means the public 
methods aren’t really public at all. You can’t access a method if you can’t see the class. 

Why would anyone want to restrict access to code within the same package? Typically, 
packages are designed as a group of classes that work together as a related set. So it might 
make sense that classes within the same package need to access one another’s code, while 
as a package, only a small number of classes and methods are exposed to the outside 
world (i.e. code outside that package). 



OK, that’s default. It’s simple — if something has default access (which, remember, means 
no explicit access modifier!), only code within the same package as the default thing 
(class, variable, method, inner class) can access that thing. 

Then what’s protected for? 

protected 

Protected access is almost identical to default access, with one exception: it allows sub- 
classes to inherit the protected thing, even if those subclasses are outside the package of the super- 
class they extend. That’s it. That’s all protected buys you — the ability to let your subclasses 
be outside your superclass package, yet still inherit pieces of the class, including methods 
and constructors. 

Many developers find very little reason to use protected, but it is used in some designs, 
and some day you might find it to be exactly what you need. One of the interesting things 
about protected is that — unlike the other access levels — protected access applies only to 
inheritance. If a subclass-outside-the-package has a reference to an instance of the superclass 
(the superclass that has, say, a protected method), the subclass can’t access the pro- 
tected method using that superclass reference! The only way the subclass can access that 
method is by inheriting it. In other words, the subclass-outside-the-package doesn’t have 
access to the protected method, it just has the method, through inheritance. 
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#3 String and StringBuffer/StringBuilder Methods 



Two of the most commonly used classes in the Java API are String and StringBuffer (remember from 
#9 a few pages back, Strings are immutable, so a StringBuffer/StringBuilder can be a lot mor efficient 
if you’re manipulating a String) . As of Java 5.0 you should use the StringBuilder class instead of 
StringBuffer, unless your String manipulations need to be thread-safe, which is not common. Here’s a 
brief overview of the key methods in these classes: 

Both String and StringBuffer/StringBuilder classes have : 



char charAt(int index); 
int length (); 

String substring (int start, int end); 
String toString(); 



/ / what char is at a certain position 
/ / how long is this 
/ / get a part of this 
/ / what’s the String value of this 



To concatenate Strings: 

String concat (string); / / for the String class 

String append (String); // for StringBuffer & StringBuilder 



The String class has: 

String replace (char old, char new); 
String substring (int begin, int end); 
char [] toCharArray(); 

String toLowerCase(); 

String toUpperCase(); 

String trim(); 

String valueOf (char []) 

String valueOf(int i) 



/ / replace all occurences of a char 
/ / get a portion of a String 
/ / convert to an array of chars 
/ / convert all characters to lower case 
/ / convert all characters to upper case 
/ / remove whitespace from the ends 
/ / make a String out of a char array 

/ / make a String out of a primitive 
/ / other primitives are supported as well 



The StringBuffer & StringBuilder classes have: 

StringBxxxx delete (int start, int end); 

StringBxxxx insert (int offset, any primitive or a char []); 
StringBxxxx replace (int start, int end, String s); 
StringBxxxx reverse () ; 
void setCharAt(int index, char ch); 



/ / delete a portion 
/ / insert something 
/ / replace this part with this String 
/ / reverse the SB from front to back 
/ / replace a given character 



Note: StringBxxxx refers to either StringBuffer or StringBuilder, as appropriate. 
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#2 Multidimensional Arrays 

In most languages, if you create, say, a 4 x 2 two-dimensional array, you would visualize a 
rectangle, 4 elements by 2 elements, with a total of 8 elements. But in Java, such an array 
would actually be 5 arrays linked together! In Java, a two dimensional array is simply an array 
of arrays. (A three dimensional array is an array of arrays of arrays, but we’ll leave that for 
you to play with.) Here’s how it works 

int [ ] [] a2d = new int [4] [2]; 

The JVM creates an array with 4 elements. Each of these four elements is actually a reference 
variable referring to a (newly created) , int array with 2 elements. 
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Working with multidimensional arrays 

- To access the second element in the third array: int x = a2d [ 2 ] [ 1 ] ; // remember, 0 based! 

- To make a one-dimensional reference to one of the sub-arrays: int [ ] copy = a2d [ 1 ] ; 

- Short-cut initialization of a 2 x 3 array: int [][] x = { { 2,3,4 }, { 7,8,9 } }; 

- To make a 2d array with irregular dimensions: 

int [ ] [] y = new int [2] []; // makes only the first array, with a length of 2 

y [ 0 ] = new int [3]; // makes the first sub-array 3 elements in length 

y [ 1 ] = new int [5]; // makes the second sub-array 5 elements in length 
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And the number one topic that didn’t quite make it in... 

#1 Enumerations (also called Enumerated Types or Enums) 



We’ve talked about constants that are defined in the API, for instance, 
JFrame.EXIT_ON_CLOSE. You can also create your own constants by 
marking a variable static final. But sometimes you’ll want to create a set 
of constant values to represent the only valid values for a variable. This set of 
valid values is commonly referred to as an enumeration. Before Java 5.0 you 
could only do a half-baked job of creating an enumeration in Java. As of Java 
5.0 you can create full fledged enumerations that will be the envy of all your 
prejava 5.0-using friends. 

Who’s in the band? 



Let’s say that you’re creating a website for your favorite band, and you want to 
make sure that all of the comments are directed to a particular band member. 

The old way to fake an “enum”: 

public static final int JERRY = 1; 
public static final int BOBBY = 2; 
public static final int PHIL = 3; 

// later in the code 

if ( selectedBandMember == JERRY) { 

// do JERRY related stuff 

} 



We've hoping that by the time we got heve 
"seledtedBand/VIembev" has a valid value/ 



The good news about this technique is that it DOES make the code easier to 
read. The other good news is that you can’t ever change the value of the fake 
enums you’ve created; JERRY will always be 1. The bad news is that there’s 
no easy or good way to make sure that the value of selectedBandMember 
will always be 1, 2, or 3. If some hard to find piece of code sets 
selectedBandMember equal to 812, it’s pretty likely your code will break... 
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#1 Enumerations, cont. 

The same situation using a genuine Java 5.0 enum. While this is a very basic 
enumeration, most enumerations usually are this simple. 



A new, official “enum”: 

public enum Members { JERRY, BOBBY, PHIL }; 
public Members selectedBandMember; 

// later in the code 

if (selectedBandMember == Members . JERRY) { 
// do JERRY7related stuff 

} / 

No need io worry about this variable's value' 



, ,\ a ttdeM** 

The seledtedBandMember" variable is of type 
"Members", and dan ONLY have a value of 

"WRY", "BOBBY", or "PHIL". 



The syntax to re-Per to an enum "instande" 



Your enum extends java. lang. Enum 

When you create an enum, you’re creating a new class, and you’re implicitly extending 
java . lang. Enum. You can declare an enum as its own standalone class, in its own 
source hie, or as a member of another class. 



Using “if” and “switch” with Enums 

Using the enum we just created, we can perform branches in our code using either 
the if or switch statement. Also notice that we can compare enum instances using 
either == or the . equals ( ) method. Usually == is considered better style. 



enum value “to a vaviable- 

Members n = Members . BOBBY; 

if (n . equals (Members . JERRY) ) System. out . print In ("Jerrrry l " ) 
if (n == Members . BOBBY) System . out . println ( "Rat Dog"); 



Members ifName = Members . PHIL; 
switch (ifName) { 

case JERRY: System . out . print ( "make it sing ") 
case PHIL: System . out . print ( "go deep ") ; 
case BOBBY: System. out . println ("Cassidy ! ") ; 

} 
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***** 



YJOVV. 






■Aed. 



P Of $uiz ./ Mat’s the output? 

;ApisseQ dwp o6 

nnswcv*: 
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#1 Enumerations, completed 



A really tricked-out version of a similar enum 



You can add a bunch of things to your enum like a constructor, methods, 
variables, and something called a constant-specific class body. They’re 
not common, but you might run into them: 



public class HfjEnum { 



,Jr passed 



enum Names { — — ‘ " the ^ ovv 

JERRY ("lead guitar^) { public String sings () { 

return "plaintively" ; } 

}, 

BOBBY ("rhythm guitar") { public String sings () { 

return "hoarsely"; } 



If 



PHIL ("bass") ; 



These are the so-6alled 

« t <, n sta^s ? e6.t.t6lassbod.es_ 

TWmk of then, as ovey.dm5 the 
basit method U th.s «*e 

ihe "si^O” method), it sm 5 0 .s 



} 



private String instrument; 

Names (String instrument) { 

this . instrument = instrument; 

} 

public String getlnstrument ( ) { 

return this . instrument ; 

} 

public String sings () { 

return "occasionally"; 

} 




This is -the enum s donst\rudtov-. |t runs 
onde (or eadh dedlaved enum value (in 
■this dase it v-uns three times). 



/ou'll see these methods being tailed -Prom "mainO". 



} 



public static void main (String [] args) { 

for (Names n : Names .values () ) { 

System . out .print (n) ; 

System . out . print (" , instrument: "+ n . getlnstrument ()) ; 
System . out . println (" , sings: " + n.singsO); 

} 

} 




KUm tomes With 3 
, "vaWesO’ method 

; typital^ ^d m a 
ru*> as show 






%java Hf jEnum 

JERRY, instrument: lead guitar, sings: plaintively 
BOBBY, instrument: rhythm guitar, sings: hoarsely 
PHIL, instrument: bass, sings: occasionally 

% 



Wotite that the basit YmgO" 
method is only dal led when "the 
enum value has no donstaht— 
spedi-fid dlass body. 
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when arrays aren’t enough 




flve-]yl3nute 
Mystery 



A Long Trip Home 




Captain Byte of the Flatland starship “Traverser” had received an urgent, Top Secret transmission 
from headquarters. The message contained 30 heavily encrypted navigational codes that the 
Traverser would need to successfully plot a course home through enemy sectors. The enemy 
Hackarians, from a neighboring galaxy, had devised a devilish code-scrambling ray that was capable 
of creating bogus objects on the heap of the Traverser’s only navigational computer. In 
addition, the alien ray could alter valid reference variables so that they referred to these 
bogus objects. The only defense the Traverser crew had against this evil Hackarian ray was 
to run an inline virus checker which could be imbedded into the Traverser’s state of the art 
Java 1.4 code. 

Captain Byte gave Ensign Smith the following programming instructions to process the critical 
navigational codes: 



“Put the first five codes in an array of type ParsecKey. Put the last 25 codes in a five by five, two 
dimensional array of type QuadrantKey. Pass these two arrays into the plotCourse() method of the 
public final class ShipNavigation. Once the course object is returned run the inline virus checker 
against all the programs reference variables and then run the NavSim program and bring me the 
results.” 



A few minutes later Ensign Smith returned with the NavSim output. “NavSim output ready for 
review, sir”, declared Ensign Smith. “Fine”, replied the Captain, “Please review your work”. “Yes 
sir!”, responded the Ensign, “First I declared and constructed an array of type ParsecKey with the 
following code; ParsecKey [] p = new ParsecKey [5]; , next I declared and constructed an array 
of type QuadrantKey with the following code: QuadrantKey [] [] q = new QuadrantKey [5] [5]; . 
Next, I loaded the first 5 codes into the ParsecKey array using a ‘for’ loop, and then I loaded the last 
25 codes into the QuadrantKey array using nested ‘for’ loops. Next, I ran the virus checker against 
all 32 reference variables, 1 for the ParsecKey array, and 5 for its elements, 1 for the QuadrantKey 
array, and 25 for its elements. Once the virus check returned with no viruses detected, I ran the 
NavSim program and re-ran the virus checker, just to be safe. . . Sir ! “ 

Captain Byte gave the Ensign a cool, long stare and said calmly, “Ensign, you are confined to 
quarters for endangering the safety of this ship, I don’t want to see your face on this bridge again 
until you have properly learned your Java! Lieutenant Boolean, take over for the Ensign and do this 
job correctly!” 



Why did the captain confine the Ensign to his quarters? 
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FivB^iinute Mystery Volition 




A Long Trip Home 

Captain Byte knew that in Java, multidimensional arrays are actu- 
ally arrays of arrays. The five by five QuadrantKey array ‘q’, would 
actually need a total of 31 reference variables to be able to access 
all of its components: 



1 - reference variable for ‘q’ 



5 - reference variables for q [0] - q[4] 

25 - reference variables for q[0] [0] - q[4] [4] 



The ensign had forgotten the reference variables for the five one 
dimensional arrays embedded in the ‘q’ array. Any of those five 
reference variables could have been corrupted by the Hackarian 
ray, and the ensign’s test would never reveal the problem. 
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